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SUMMARY 


This report describes the Generalized Advanced Propeller Analysis 
System (GAPAS) computer code. GAPAS has been developed to analyze advanced 
technology multi -bladed propellers which operate on aircraft with speeds up 
to Mach 0.8 and altitudes up to 40,000 feet. GAPAS Includes technology for 
analyzing aerodynamic, structural and acoustic performance of propellers. 
The computer code has been developed for the CDC 7600 computer and is 
currently available for industrial use on the NASA Langley computer. 

A description of all the analytical models incorporated in GAPAS is 
included. Sample calculations are also described as well as users 
requirements for modifying the analysis system. Computer system core 
requirements and running times are also discussed. 
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1. INTRODUCTION 


This report describes the Generalized Advanced Propeller Analysis 
System (GAPAS) computer program developed for the NASA Langley CDC 7600 
computer system. GAPAS has been developed in a unified but modular form. 

The current version of GAPAS contains a set of computer codes which 
addresses propeller performance, airfoil loading, aircraft flowfield 
effects, propeller acoustics, and propeller structural analysis. At the 
present time an aeroelasticity module for analyzing advanced propellers is 
unavailable, however, many of the required links to the other modules have 
already been provided. In addition, this version of GAPAS will only 
address solid propellers of one material. This limitation can be removed 
by the appropriate modification of the Geometry Generator module. 

Chapter 2 describes the details of each of the individual modules 
including a summary of the governing equations, boundary conditions, 
initial conditions, numerical techniques, options, limitations, etc. 

Chapter 3 describes the GAPAS executive system, compiler options, 
input/output variables, tape and file assignments, storage requirements, 
sample deck setups for test cases, typical running times, and operating 
1 imitations. 

Although the current version of GAPAS contains only one analysis code 
for each discipline, the code has been developed in modular form and the 
existing modules can either be modified or replaced with newer state-of- 
the-art analysis tools. Additional analysis codes can also be incorporated 
such that the user has a choice of which codes to use in each discipline. 

As an example, the user may prefer to use a less sophisticated analysis 
tool for some preliminary design studies, after which, he may then utilize 
one of the sophisticated analysis codes for a more detailed analysis. 
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2. MODULE DESCRIPTION 


2.1 GEOMETRY GENERATOR MODULE 

2.1.1 Problem Definition 

The geometry generator module Is necessary to define the shape of the 
the propeller and to calculate quantities that are passed to the aircraft 
flow field, propeller performance, airfoil loading, acoustics, structures 
and aeroelasticity modules through the data base. The interplay among the 
modules as seen by the geometry generator module is indicated schematically 
in Figure 2.1-1, where the symbols represent position vectors, normal vec- 
tors, deflections and angles. The geometry generator module was developed 
at TRW based on the geometrical requirements of the other modules. 

2.1.2 Propeller Geometry 

The propeller geometry is typically specified by local airfoil pro- 
files that are input perpendicular to a given arbitrary line. In the cases 
considered thus far, the arbitrary line has been taken to be the pitch- 
change axis (PCA) , but it can be any smoothly varying line in space — an 
important generalization for a future design mode and when defining the 
blade after aeroelastic deformation. The leading edge of the profile with 
respect to the arbitrary line is input along with the local chord length 
and the local twist angle relative to the plane of rotation. The input 
profiles are given with arbitrary chordwise spacing at each input slice, 
but are then redefined with spacing appropriate to the program option being 
exercised. The coordinates at comparable points on each profile are con- 
nected by "wires" from the hub to the tip, as depicted in Figure 2.1-2 for 
the SR-3 propeller blade. Also shown in the figure is the geometry of the 
nacelle defined in the aircraft flow field module. Taking slices, we can 
find the intersection of each wire with a plane defined perpendicular to a 
particular line. Then, connecting the wire intersections, we can define 
the profile in the plane of the slice. The transformation matrices that 
are used to express the coordinates in another reference frame are access- 
ible through the data base and are transferred to the modules that require 
them. They define the in-plane and out-of-plane sweep angles, and the 
local twist angle. 
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(Loads) 



(Profiles) 


A 


3/4 


List of symbols 

for Figure 2.1-1. 

{*1/ 4 } pc ' {~l/4. 

g quarter-chord point (defines the propeller plane) 

{*3/4}pc 

control point on 3/4-chord drive 

ffpc 

normal vector at control point 

Ml. Mpc 

airfoil profile points 

^3/4 

twist angle at 3/4 radius location 

Ml 

Inflow velocity in the propeller plane 

V, 

twist increment due to aerodynamic and inertial loads 

{^*1 , sllpc 

deflection of line of shear centers due to aerodynamic 
and inertial loads 

Subscripts 

pc 

B 

L 

quantity measured in pitch-change frame 
quantity measured in body-fixed coordinates 
quantity measured in local frame 


Figure 2.1-1. GAPAS as Seen by Geometry Generator 
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Figure 2.1-2. SR-3 Propeller-Nacelle Geometry 


In the performance mode it Is important to have enough wires in the 
nose region so that the profiles calculated from slices perpendicular to 
the quarter chord can be analyzed by the airfoil loading module. On the 
other hand, the structural module operates better with clockwise elements 
that are roughly equally spaced in order to calculate an accurate value for 
the profile shear center. 


2.1.3 Coordinate Systems and Transformation Matrices 


It is important to be able to transform the coordinates from one 
reference frame to another. Each transformation matrix is a combination of 
rotations about the x-, y-, or z-axes, represented by the matrices Lj, L 2 , 
and l_ 3 , 



1 

0 

0 


L lW = 

0 

cos(^) 

sin(^) 

(2.1-1) 


0 

-sin(^) 

costy). 



COS ((f)) 

0 

-sin(^) 

1 

L 2 (f» - 

0 

1 

0 

(2.1-2) 


■ sinty) 

0 

cos(0). 



cos(^) 

sin(0) 

0 


L3W = 

-sin(^) 

cos(^) 

0 

(2.1-3) 


0 

0 

1 



Figure 2.1-3 shows an example of rotation about the x-axis, Li(^). 

The transformations necessary to proceed from the wind-axes frame to 
the local coordinates are indicated in Figure 2.1-4. Starting with a wind 
axis frame where the x-axis is aligned with the velocity vector of the 
center of gravity of the body, the y-axis is horizontal to the right, and 
the z-axis is downward to give a right-handed coordinate system, we can 
define the transformation to the body-fixed reference frame in terms of the 
sideslip angle, p, and the angle of attack, a, 
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Figure 2.1-4. 


Coordinate Transformations Used in GAPAS 










(2.1-4) 


l-Brw “ L 2( fl ) l 3 i-p) 

That is, we yaw to the left about the z-axis with angle p and pitch up 
about the y-axis with angle a. Multiplied out with the row by column rule 
for matrix multiplication, this transformation matrix becomes 


L[JtW 


cos(a)*cos(/J) -cos(a)*sin(/?) -sin(a) 
sin (/?) cos (p) 0 

sin(a)*cos(/7) -sin(a)*sin(/?) cos (a) . 


(2.1-5) 


Since the transformation matrices are orthonormal, the inverse 
transformation (for the airplane body-fixed axes to the wind axes) is 
easily found by taking the transpose of [l-B f nw]i 

L w ,b ■ iW » L 3 (/» L 2 (-o) (2.1-6) 


or 


Lw,B 


cos(a)*cos(/J) 

-cos(a)*sin(y?) 

-sin(a) 


sin(^) sin(a)*cos(/J) 
cos [p) -sin(a)*sin(/J) 
0 cos (a) 


(2.1-7) 


The geometry of the transformation from the wind axes to the body-fixed 
frame is described in Figure 2.1-5. 

The propeller-hub axes are required in order to define the propeller 
plane and determine the induced velocity components for use in the 
propeller performance analysis. The right-thrust angle, and down- 
thrust angle, a<j, define the transformation to the propeller hub axes from 
the body-fixed axes. Therefore, 

LpHi B = L 2(-ad) L 3(^r) (2.1-8) 

The angles involved in the transformation from the body-fixed frame to the 
propeller-hub axes are shown in Figure 2.1-6. 

The transformation from the prop-hub axes to the pitch-change axes 
first involves a quarter-rotation about the z-axis so that the y-axis 
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X B 



Figure 2.1-5. Transformation From Wind Axes to Body-Fixed Frame 



Figure 2.1-6. Transformation From Body-Fixed Frame to Prop-Hub Frame 
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points along the rotational axis of the propeller. Then, the blade is 
rotated through the azimuth angle, 

LPC,PH = L 2(l0 L 3 ("§] (2.1-9) 

The propeller geometry is then described with respect to an arbitrary line 
defined in this coordinate system. The profiles perpendicular to this line 
are given in local coordinates with the leading edge, chord, and twist 
angle defined at specified values of the distance along the PCA. Once the 
blade is defined, an additional twist, A/ 33 / 4 , about the pitch-change axis 
will be made to account for different blade operating conditions. The 
geometry of the transformation from the propeller-hub frame to the pitch- 
change axes is shown in Figure 2.1-7. 

The transformation to the local frame is defined by finding the 
tangent vector to the arbitrary line and using the components of the 
tangent vector to define the in-plane and out-of-plane sweep angles. 

Finally, the twist angle is applied to give the transformation from the 
reference frame to the local frame. The way that the final twist angle is 
applied depends on the direction of rotation, since the profiles are always 
defined such that the local x-axis is along the profile from the leading to 
the trailing edge. The transformation from the reference frame to the 
local frame is 

l L»PC = *-3 (-/*) L l(0out) L 2(lHn) (2.1-10) 

when the propeller rotates in a clockwise direction when observed from the 
front — like the SR-3. When the propeller rotates in a counterclockwise 
direction — like the Hartzell 101/16 — the transformation from the 
reference frame to the local frame is 

Ll.PC = l 3 (~P) L l(-0out) l 2 (“iHn _T ) (2.1-11) 

where the local profile is aligned so that the x-axis of the profile starts 
at the leading edge and goes to the trailing edge, while the local y-axis 
points toward the suction side of the profile. 
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Figure 2.1-7. Transformation from Prop-Hub Frame 
to Pitch-Change Axes 
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The transformations are summarized in Figure 2.1-8. The in-plane and 
out-of-phase sweep angles, ^ n , and ^out» are shown in figures in Section 
2.1.5 for clockwise and counterclockwise rotation. 

2.1.4 Cubic Spline Interpolation 

There are many applications of the subroutines SETSPL and CSPLINE to 
setup and Interpolate with cubic splines. The usual method of application 
is to find the spline-fit coefficients using the approximate arc length, s, 
as the independent variable. Following Figure 2.1-9, the "arc-length" is 
defined such that 

s i+ i = s, + J dx* 7 dyf ~ dzf . 

where 

dx i = x 1+l _ x i 

dy i = y i+i - y i 

dz i = z i + i - z i* 

If f is a dependent variable that can be either x, y, or z, we assume that 
each component f has a cubic form within each segment, 

f(s) = fi + £i *ds(i ) + (l/2!)*^i"(1)*ds(i) 2 + (2.1-14) 

+ (l/3!)*ei " ’ *ds(i) 3 , 

where 

ds(1) = s - si, (2.1-15) 

and where s is the independent variable. From segment to segment, the 
values of the function, first derivative, and second derivative are assumed 
to be continuous. The third derivative is allowed to be discontinuous, 
thus the definition of the "knot". 

Expressing the third derivative £-j in terms of the second derivative 
at the endpoints f}‘, f+i and requiring continuity of the first derivative 
f'(s) at the endpoints, we obtain a tridiagonal equation for f" in terms of 
the functional values at the knots. 


( 2 . 1 - 12 ) 

(2. l-13a) 
(2 . l-13b) 
(2 . 1 -13c) 
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W: Wind Axes 


B: Body Axes 


PH: Propeller Hub Axes 


PC: Pitch Change Axes 


R: Reference Axes 


L: Local Axes 


kw " L 2 (q ' ) L 3 (-^) 

t~ Ann la 


Angle of 
Attack 


Sidesl Ip 
Angle 


Right-Thrust 

Angle 


iPH,B “ k2 ( “ a D 

Downthrust I 
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k,PH = k 0) h ( " 2 ] 

Azimuth Angle 


kPH = b ( -^3/4 } or b W 3/4 ) 
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* — — Onornt Inn Arm 1 n « ~r 


J cw CCW 

Operating Angle at 3/A Radius 

iUR = t3 ( -/ ) Ll(%ut ) t2 ( ' ( 'in )or k3 ( -^Ll<-< s out , k2 < -' (, in- ,r) 

/ f / 

Twist Angle / In-Plane Sweep Angle 
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Figure 2.1-8. Summary of Coordinate Systems 
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Arbitrary Line 
Local Profiles 


Pressure, Skin Friction, 
Shear Center 


x(s) 

|x(s)| pc = y(s) 
z(s) 

For each component, |, 
4 = + t[(s - Sj) + 


where 4 can be x, y or z 
i 4 j(S - Sj) 2 + jj- (s - S|) 3 


Match 4, 4', 4" at "knots" (where 4"' is discontinuous) 

Boundary Conditions 

(1) Cantilever (4' = const) 

(2) Free (4" = 0) 

(3) "Not-a-knot" (continuous 4 '" at i = 2 or i = N - 1) 

Figure 2.1-9. Cubic Spline Interpolation 



h i-i «i-i + 2 < h i-i * h i>«i * * 


(2.1-16) 


= 6 


ji+i ~ ~ ^i-i 

h i ' h i-i 


where = s.. + j 


- *v 


' 1-1 


= s i " s i-l* 


Finally, the boundary conditions at each end of the spline are assumed 
to satisfy one of follow conditions: 

(1) Cantilever condition ... or £n equal to a given constant. 

(2) Free-end condition ... or £f} equal to zero. 

(3) "Not-a-Knot" condition ... ‘ = (2 or fN-2 = $N-1* 

When extrapolating, we take the slope equal to a constant, and extrapolate 
from the end point. 

The calculation of the spline-fit coefficients Is performed in 
subroutine SETSPL. the interpolation/extrapolation using the spline-fit 
coefficients is performed in subroutine CSPLINE. 

2.1.5 Blade Geometry Definition 

The three-dimensional blade geometry is developed using a five-step 
process as outlined below. 

(1) Define an arbitrary line and input profiles perpendicular to this 
line. Typically this line is the pitch-change axis (PCA) or the 
line of shear centers (when considering a deflected blade). The 
spline-fit coefficients for the arbitrary line are set up, since 
it will be necessary to define planes perpendicular to it. 

(2) At a given radial station along the arbitrary line, the 
transformation from the pitch-change frame to the local frame is 
defined in terms of the in-plane sweep angle, ^ n , the out-of- 
plane sweep angle, ^ 0 ut» anc * the local twist angle p. First the 
coordinates are rotated about the y-axis through the in-plane 
sweep angle, tf-j n , so that the local tangent vector is in the new 
y-z plane. Then, the coordinates are rotated about the new x- 
axis through the out-of-plane sweep angle, ^ 0 utr so that the 
tangent vector to the defining arbitrary line is along the local 
z-axis. Finally, the coordinate system is rotated through the 
local twist angle, p, so that the new x-axis is parallel to the 
local chord of the airfoil. The transformation matrix from the 
PC-frame to the local frame is 
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(2.1-17) 


l L,PC = L l(0out) L 2 (lMn) 

for the case of clockwise rotation like the SR-3 while for 
counterclockwise rotation 


L|_,PC = L 3 (-p) Lj(-^out) *- 2 (~ 1^1 n - *") (2.1-18) 

The In-plane and out-of-plane sweep angles are schematically 
represented in Figures 2.1-10 and 2.1-11 for clockwise and 
counterclockwise rotation. 


(3) The local nondimensional profile is defined with respect to the 
leading edge of the airfoil, 



(2.1-19) 


where x and y are the coordinates measured from the nose of the 
airfoil, nondimensional i zed with respect to the local chord, c. 
The leading edge point (x-j e } |_ is defined relative to the point 
where the arbitrary point pierces the local plane, {XoutiL b y 
the leading-edge alignment, LEA, and the horizontal alignment, HA 



~out 


}l 



( 2 . 1 - 20 ) 


The defining "arbitrary" line that defines the propeller blade 
sections is typically the pitch-change axis. The generalization 
of the arbitrary line is important for the case where the blade 
deflects and twists under the inertial and aerodynamic loads. In 
that case, the profiles will be redefined with respect to the 
line of shear centers and will be assumed to be undeformed as the 
line of shear centers deflects and twists. The propeller blade 
section is defined in local coordinates as indicated in Figure 
2 . 1 - 12 . 

Although the defining profiles were input with arbitrary spacing, 
we can redefine the profiles in terms of user-specified "nicely 
spaced" coordinates. Each profile will have the same 
nondimensional spacing which will then be connected to form a 
three-dimensional surface. The profiles are fitted with planes 
and interpolated to determine these new local coordinates. The 
leading edge radius is also calculated and stored in the data 
base. 
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Figure 2.1-10. Sweep Angle Definitions for Clockwise Rotation 
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Figure 2.1-12. Airfoil Section Local Coordinate System (LCS) 



(4) The "global coordinates" of the “nicely spaced" profile are 
defined by 


{ 2 } pc - { 2 a rb } PC + L PC,L [ c { * }l + { «le " *arb }l ] ^ 2,1 21 ^ 


(5) 


where {x QU t} is the reference point on the arbitrary line, Lpc, L 
is the transformation matrix from the local coordinate frame to 
the pitch-change frame (egual to the transpose of L|_ ( pc) » c I s 
the local chord length, {x} Is the nondimensional point on the 
profile, and {x le } is the leading edge location. The subscripts 
PC and L refer~to the reference frame of measurement - 
pitch-change or local. 


Define the "wires" connecting profile to profile. The spline-fit 
coefficients are set up and stored for future use since it will 
be necessary to take cuts perpendicular to a different arbitrary 
line depending on which module is being utilized. 


The geometry for the SR-3 propeller following these steps is shown in 
Figures 2.1-13 and 2.1-14 where the profiles perpendicular to the line of 
shear centers are also indicated. 


2.1.6 Intersection of a Wire with a Plane Perpendicu lar to an Arbitrary 
Line 

Once the cubic spline is set up for an arbitrary line (subroutine 
SETARB) , it is a straightforward matter to find the tangent vector at any 
point on the line defined by the distance R along the pitch-change axis (z- 
axis). This is done by finding the root of a function defined by 

F(s) = z (s) - Ri = 0. (2.1-22) 


The value of s is varied until the function Is equal to zero within a 
specified tolerance. The other two coordinates can be calculated by 
interpolation using the same value of s and the appropriate spline-fit 
coefficients. The derivatives, x'(s), y'(s), and z'(s) determined from 
this interpolation are used to establish the unit tangent vector at the 
point on the arbitrary line. 



(2.1-23) 
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where 


d - i (x')2 + (y)2 7 (z')2. 

Then, the plane perpendicular to the point (xout.O)} Is determined by 
another function 


Fl(s) » (x(s) - x,arb(1)} • { f } = 0, (2.1-24) 

where (x(s)} Is the point defined by the wire spline-fit coefficients and 
{t} is the tangent vector. Using the function subroutine ZEROIN, we can 
find the root of this function by varying the value of s. 

2.1.7 Structural Module Requirements 

The structures beam module requires a consistent set of profiles 
perpendicular to the line of shear centers as part of setting up the beam 
elements. The methodology for obtaining these profiles is based on an 
iterative scheme consisting of the following five steps. 

(1) An initial guess is made for the line of shear centers. As a 
first approximation, it is presumed to be the line of midchords. 
Based on this line, the spline-fit coefficients are determined. 

(2) The profiles perpendicular to this line at each of the input 
stations (R^ ) are then determined. 

(3) The shear center of this profile, using the methods described in 
the structures section, is then determined. 

(4) Check the new location of the shear center with the previous 
location and iterate until a specified tolerance in the change in 
shear center location is made. 

(5) Set up the new spline coefficients for the new line of shear 
centers and return to Step (2), if the convergence criteria are 
not met. 

2.1.8 Propeller Performance Modules Requirements 

In order to calculate the propeller performance and acoustic signature 
of the propeller, it is necessary to calculate specific input to these 
modules. These include the locations of the trailing vortex points and 
control points for input into the Chang-Sul 1 Ivan propeller performance 
module and to determine the appropriate section profiles for airfoil 
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loading and acoustics modules. The methodology incorporated on the 
geometry module follows a 12 step approach: 

(1) Read the specified output radial stations, R 0 . 

(2) Setup a line through the quarter-chord points based on the 
Initial profiles. The spline-fit coefficients are used to setup 
the tangent vector, {t}pci at each radial station. 

(3) Profiles are found perpendicular to the quarter-chord line by 
finding the location where each wire pieces the plane. That is, 
for each point on a wire {x(s)}pc, we vary s until 

{ x(s) - JSi /4 }pc ' { ~ }pc ’ °- (2.1-25) 

This calculation is performed in using function subroutine SLICE. 

(4) For each profile we find the leading edge (xie) trailing edge, 
{xt e } chord length c, twist angle p, and transformation matrix, 
l_L , pc , from the pitch-change frame to the local frame. 

(5) Set up the spline-fit coefficients defining the profile shape 
starting at the trailing edge moving around the nose along the 
upper surface and back to the trailing edge along the lower 
surface (subroutine SETSPL) . A finite trailing edge is allowed 
in the analysis. 

(6) Determine the camber line for the profile. In particular, The 
quarter-chord point on the camber line is the location where the 
trailing vortices are assumed bound to the propeller. The camber 
line is determined by varying the independent parameter s 
(approximate arc length as explained In Section 2*1.4) until 

F(s) = { x(s) - a 1 } • { t u - t L (s) ) = 0 (2.1-26) 


where, from Figure 2.1-15, (x(s)} Is a point on the lower 
surface of the airfoil, {xi} is a “knot" on the upper profile, 
{t u } is the tangent vector on the upper surface and {tL(s)} 
is the tangent vector on the lower surface. This defines a 
vector (x(s)-xi} that is perpendicular to the average of the two 
tangent vectors. The point halfway between the upper and lower 
points is on the camber line. The calculation is performed in 
subroutine camber using function subroutine FCAMB and ZEROIN. 

(7) Define profiles perpendicular to the quarter-chord line midway 
between the previous profiles. This airfoil section is required 
by the airfoil loading module to determine the loading and 
moment. 
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FIND CAMBER LINE AND 1/4-CHORD POINT ON CAMBER LINE 



TRAILING VORTICES BOUND TO THE PROPELLER BLADE AT 1/4-CHORD LOCATION 


Figure 2.1-15. Camber Line and Quarter-Chord Point 


(8) Define the camber line on this airfoil section in a manner 
similar to Steps (5) and (6). 

(9) Find the control point and normal vector at the three-quarter 
point on the camber line for use in the Chang-Sul 1 ivan 
performance module (Figure 2.1-16). The boundary condition 
required to determine the strengths of the unknown bound vortices 
requires that the normal component of the velocity is zero at 
this control point. The inflow velocity components are required 
in the propeller plane in order to satisfy the above boundary 
conditions. The quarter-chord load point is used to define the 
propeller plane, which is then transferred through the data base 
to the aircraft flow field module. After the velocity components 
are calculated by the aircraft flow field module, they are 
transformed to the global coordinates used by the propeller 
performance module (Chang-Sull Ivan) 

( X )CS = kS,PC ( V }PC (2.1-27) 


where the transformation matrix from the pitch-change frame (PC) 
to the Chang-Sull ivan frame (CS) Is 

L CS,PC = l 3 (*/ 2 ) 1-1 (*V2) (2.1-28) 
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APPLIED FORCE 
AND MOMENT 



TRAILING VORTICES 


CONTROL POINT 


NORMAL VECTOR AT CONTROL 
POINT. PERPENDICULAR TO 
LINE OF 3/4 CHORDS AND 
LOCAL CAMBER LINE. 


Figure 2.1-16. Find Control Point, Load Point and Trailing Vortex Point 
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(10) The transformation matrix L|_ ( pc is saved In order that components 
of the local aerodynamic forces and moments can be transformed to 
global (pitch-change) coordinates for use In the structures 
module. 

(11) Execution of the acoustics module requires the definition of the 
profiles perpendicular to the pitch-change axis. In particular 
the local nose radius, Rr, and the thickness to chord ratio, t/c. 

(12) Set up elliptic coordinates for Interpolation of the surface 
pressure distribution for the acoustics module. The elliptic 
coordinates are described in Section 2.5.3 of this report. 

2.1.9 Blade Reflection - Iterative Calculation 

The line of shear centers and the profiles perpendicular to it are 
described in Section 2.1.7 of this manual and Section 2.2.1 of the GAPAS 
final report. When the line of shear centers Is constructed, the profiles 

normal to this line are stored so that the blade geometry can be 

reconstructed after the beam elements are deflected and twisted. In the 
iterative scheme, the loads computed by the propeller performance module 
are passed through the data base to the structures module. The structures 
module then calculates the deflection and twist of the beam elements based 
on the aerodynamic and inertia loads. Now, the new propeller blade is 
constructed using the new line centers as the defining line with the 
previously stored profiles constructed perpendicular to this line with an 
incremental local twist angle added to account for the twist on the beam. 
New loads can be found from the performance module and the next iteration 
on the deflected shape of the beam elements (line of shear centers) can be 
found. This procedure is continued until convergence based on the 
Incremental displacement Is attained. Sample calculation with the 
undeflected shape and the first three Iterations are shown In Figure 
2.1-17. These results indicate that there are some problems with the 

convergence of this preliminary version of the iterative scheme. 

2.1.10 G400 Interface 

the G400 Interface is not completely Implemented into GAPAS. However, 
some of the required geometrical and structural properties are calculated 
and stored in the data base. A major effort will be required to allow 
GAPAS to interface efficiently with the stand-alone version of the G400 
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UNDEFLECTED LINE OF SHEAR CENTERS 

DEFLECTED LINE OF SHEAR CENTERS 



Figure 2.1-17. Undeflected and Deflected Line of Shear Centers 
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code. This will require a clarification of the Input variable definitions, 
including the Input parameters for the various options and flag settings. 
Radius, number of segments, mass, Inertia, torsion stiffness, etc. have 
been written into arrays, but other quantities such as flatwise modal 
frequencies, explicit edgewise spring rates, etc., have not been computed. 

2.1.11 Geometry Generator Subroutine Summary 

The geometry generator module contains the subroutines described 
below: 

GEOGEN - The main driver routine. 

INPUT - This subroutine reads the input data for defining profiles and 
calls routines to redefine coordinates and set up spline-fit 
coefficients for the wires. Called by GEOGEN. 

NICE - Subroutine for generating "nicely spaced" wire coordinates. Find 
leading and trailing edges of the profiles. Called by INPUT. 

FCHORD - Function to minimize finding the longest chord. Called by NICE. 

FCOORD - Function used by ZEROIN to find the "nicely spaced" coordinates. 
Called by NICE 

SETARB - Subroutine to set up splines for arbitrary line. Called by INPUT, 
GGENDR. 

SPWIRE - Subroutine to spline fit the wire data in pitch change frame. 

This routine finds the sweep angles and the transformation matrix 
from the local frame to the pitch change frame, Lpc t |_* The 
profiles are input perpendicular to arbitrary line #1. Called by 
INPUT. 

LPERP - Subroutine to calculate the transformation matrix for the plane 
perpendicular to the given arbitrary line at the input radius. 
Called by SPWIRE, PROFIL. 

FRAD - Function to calculate the difference between input radius and 
calculated radius versus interpolation distance, s. Used by 
ZEROIN, called by LPERP. 
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SETWIR - Subroutine to set up splines of the wires. Called by SPWIRE. 

PROFIL - Subroutine to calculate propeller section properties for a slice 
perpendicular to an arbitrary line. Called by GGENDR. 

SLICE - Subroutine to find the Intersection of a wire with the plane 
perpendicular to an arbitrary line. Called by PROFIL. 

FSLICE - Function to calculate the difference between input radius and 
calculated radius versus interpolation variable s. Called by 
SLICE. 

CAMBER - Subroutine to calculate the camber line in an arbitrary slice. 
Called by PROFIL. 

FCAMB - Function to find the location of the camber line. Called by 
CAMBER. 

CLINE - Function subroutine to find the camber-line location at the 
nondimensional x-coordinate. Called by GGENDR using ZEROIN. 

PSLICE - Subroutine to output the slice information. Called by GGENDR. 

ROTATE - Subroutine to rotate the input blade coordinates through the 

angle DBET34. Higher values of DBET34 increase the pitch 
setting. Called by INPUT. 

SETSPL - Subroutine to set up coefficients for cubic spline interpolation. 
Parameters allow for cantilever, free or "not-a-knot" end 
boundary conditions. Called by NICE, SETARB, SETWIR, PROFIL, 
CAMBER, GGENDR, G400. 

CSPLINE - Subroutine to interpolate (or extrapolate) cubic spline function. 
Called by FCHORD, NICE, FCOORD, FRAD, LPERP, FSLICE, SLICE, 

FCAMB, CLINE, GGENDR, FROUT, G400. 

INTEG - Subroutine to integrate a spline function. Called by G400. 

SL - Subroutine to calculate the rotation matrix L n (x), representing 

the angular rotation x about the n-axls. Called by LPERP, 

SPWIRE, PROFIL. 
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MVMULT 


- Subroutine to multiply matrix [A] by vector {;$}: {y} = [A]{g}. 

Called by SPWIRE, PROFIL, FSLICE, GGENDO, G400. 

MMMULT - Subroutine to multiply matrix [A] by matrix [B] : [C] = [A][B]. 

Called by LPERP, SPWIRE, PROFIL. 

TRANSP - Subroutine to calculate the transpose of matrix [A]. Called by 
SPWIRE, GGENDR. 

CROSS - Subroutine to calculate the cross product {c} = {a}x{b}. Called 
by GGENDR, VOLUME. 

DOT - Function subroutine to calculate the dot product DOT = {a}*{b}. 
Called by VOLUME. 

XNORM - Function subroutine to calculate the norm of a vector. Called by 
GGENDR. 

FMIN - Function subroutine to find an approximation to a point where F 
(from external subroutine) attains a minimum on the interval (AX, 
BX). Called by NICE (FCHORD) . 

ZEROIN - Function subroutine to compute a zero of the function F(x) 

(external function) in the Interval (AX, BX). Called by NICE 

(FCOORD) , LPERP (FRAD), SLICE (FSLICE), CAMBER (FCAMB) , GGENDR 
(CLINE, FCIRC) , G400 (FROUT). 

G400 - Subroutine to calculate the Input parameters for the G400 PROP 

aeroelasticity module. Called by GGENDR. 

SEGVOL - Subroutine to calculate the segment volume. Called by G400. 

VOLUME - Subroutine to calculate the volume of a tetrahedron. Called by 

SEGVOL. 

FROUT - Function subroutine to find the value of s at nondimensional 
radius ROUT. Called by G400. 

FCIRC - Function subroutine to determine the location of the 3/4-chord 
control point on a circular arc for the Chang-Sul 1 i van 
performance module. Called by GGENDR using ZEROIN. 

SHRCTR - Driver subroutine for the shear center iteration. Called by 
GGENDR. 
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CAPSHR - Subroutine to calculate the section properties and shear center 
location of an arbitrary airfoil section (solid or multlcel led) 
composed of one isotopic material. This Is a finite element code 
that models the cross section using quadrilateral plate finite 
elements. Called by SHRCTR. 

CENTER - Subroutine to calculate the center of a triangular finite 
element. Called by GAPSHR, QUAD. 

AREA - Subroutine to calculate the area of a triangular finite element. 
Called by GAPSHR, QUAD. 

INERT - Subroutine to determine the moments and products of inertia of a 
triangular element in a quadrilateral element. Called by GAPSHR. 

WRPCON - Subroutine to determine the third and fourth area moment 

integrals of a triangular element in a quadrilateral element N 
(for constants in G400 PROP aeroelasticity module). Called by 
GAPSHR. 

TEMAT - Subroutine to determine the T matrix for a triangular element in 
quadrilateral element N. Called by GAPSHR. 

QUAD - Subroutine to determine the stiffness and load matrices for the 
quadrilateral element N. Called by GAPSHR, QUAD. 

SYMSOL - Subroutine to solve a set of linear algebraic simultaneous 
equations. Called by GAPSHR. 
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2.2 AIRCRAFT FLOW FIELD 
2.2.1 Problem Definition 


The aircraft flow field module Is used to calculate the axial, radial 
and tangential components of the velocity at arbitrary locations In the 
plane of the propeller using Incompressible potential flow methods. The 
computational approach accounts for airplane angle of attach and sideslip, 
nacelle shape, and upwash due to the lifting wing, but neglects the 
velocity induced by the propeller. These components of the Inflow velocity 
are required by other modules within GAPAS for the calculation of 
performance, airfoil loading, and acoustic signature of the propeller. The 
aircraft flowfield Is shown schematically in Figure 2.2-1. 

2.2.2 Aircraft Flow Field Methodology 

Jumper's code (Refs. 2.2-1 and 2.2-2) Is based on the panel methods 
of Hess and Smith (Ref. 2.2-3) and is written specifically to calculate the 
flow field in the propeller plane of a typical general aviation airplane. 
This code models the fuselage (and nacelles, If applicable) by source 
panels, the strengths of which are determined by satisfying the condition 
that the velocity normal to the surface vanish at the center of each panel. 
The boundary conditions are relaxed at panels simulating air Inlets and 
outlets. The wing Is replaced by a single horseshoe vortex. In satisfying 
boundary conditions at each panel, the velocities Induced by the horseshoe 
vortex are Included. The result Is a set of simultaneous algebraic 
equations, equal in number to the number of panels, for the unknown source 
strengths. The equations are then solved using the Gauss-Seidel iteration 
method. 

Knowing the panel source strengths, the program then calculates the 
velocity and pressure field over the body surface. Finally, velocity 
components are calculated at specified points in the propeller plane. The 
definition of the propeller plane was modified so that swept blades, such 
as the SR-3, could be considered. The velocity components were calculated 
at the quarter-chord location along the blade for specified angular 
position of the pitch-change axis. 
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FREESTREAM VELOCITY 


OBJECTIVE: CALCULATE THE AXIAL TANGENTIAL AND RADIAL VELOCITY COMPONENTS AT A SPECIFIED POINT IN THE PROPELLER PLANE 

REQUIRED: . PROPELLER PLANE DEFINITION 
• VELOCITY CONTRIBUTIONS 

(1) FREESTREAM VELOCITY (OPERATING CONDITIONS) 

(2) FUSELAGE INDUCED VELOCITIES (SOURCES/SINKS) 

(NACELLE AND FUSELAGE GEOMETRY) 

(3) WING INDUCED VELOCITIES (VORTICES) 

(WING GEOMETRY) 

Figure 2.2-1. Aircraft Flow Field Effects 



The program logic of Jumper's code generates either triangular or 
quadrilateral panels depending upon the specification of points around a 
section contour. This Is Illustrated In Figure 2.2-2 taken from Reference 

2.2- 2. In this figure, a value of the logic parameter NFLAG of 1 signals 
either that the section Is repeated or is the end of the body. The panels 
are generated and Indexed locating the unit normal vector directed outward 

i r . 

from the center of each panel. For a triangular panel, this procedure Is 
straightforward since the points are always coplaner. For a quadrilateral 
panel, the unit vector is obtained from the cross product of the diagonals. 
Then a plane panel is generated by projecting the original points onto a 
plane normal to the unit vector which contains the average of the 
coordinates of the original points. Two or more successive points on a 
cross-section having the same coordinates results in the generation of one 
or more triangular panels. 

Except for the mechanics of paneling the body, locating control 
points, and determining unit vectors normal to the panels, Jumper's program 
follows the approximate representation for distributed sources proposed by 
Hess and Smith (Ref. 2.2-3). Referring to Figure 2.2-3, the self-induced 
velocity at the centroid of a panel due to a continuous source strength in 
unit area, q(I), distributed over the panel can be written Immediately as, 

{ V(I) } = \ q ( I) { fi(I) } (2.2-1) 

where {n (I) } is the unit normal vector at the center of the Ith panel. The 
velocity induced by the Jth panel is approximated by assuming that the 
distributed source is concentrated at the centroid, of the panel, rather 
than integrating the distribution over the panel. Hess and Smith (Ref. 

2.2- 3) point out that this is acceptable if the distance between centroids 
is larger than four times the maximum panel diagonal. Otherwise, the 
quadrupole terms in the multipole expansion should be included, or the 
exact integrates should be calculated. Then, the velocities induced by the 
source panels are 

{ X S U) } - i q(I) { n(I) } + H S (J) q(J) ( g(i,j) ) ( 2-2 . 2) 

Ml (I,J) 1 1 
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Figure 2.2-2. 


Sample Body Cross Section Input Showing a Repeated Cross 
Section Description and Indicating the Input Sequence 
of Periphery Points 



Figure 2.2-3. Distributed Sources at I Panel and Point Source at J Panel 
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where r(I,J) is the distance from the centroid of the Jth panel to the 
centroid of the Jth panel and (e(J)} Is the corresponding unit vector along 
r(J) . 

The velocity Induced by a vortex element of strength {r} Is given by 
the Blot-Savart Law 


{ V p > } ■ 



(2.2-3) 


The Induced velocity for a straight line vortex segment Is calculated In 
subroutine VORTEX. Jumper's code replaces the wing with a single horseshoe 
vortex located at the quarter-chord of the wing. The spacing of the 
trailing vortices is t/ 4 times the physical span of the wing. The strength 
of the vortex is determined from the operating conditions by noting that 
the lift, L, is 

L = p V* T J b = \ p v£ C L S (2.2-4) 

where p is the air density, b is the span, V„ is the freestream velocity, 

C|_ is the wing lift coefficient, and S is the reference wing area. The 
velocity components induced by the vortex are calculated in subroutine 
WINGV. 

Assuming that the total velocity at any point is the sum of the 
freestream velocity, the velocity induced by the source panels, and the 
velocity induced by the horseshoe vortex, 

{ l (I) } • { !L + V S (I) «■ X V (I) ) (2.2-5) 

then the linear set of equations to be solved for the source strength q ( I ) 
is found by requiring that the normal component of velocity is equal to 
zero 


{ "(I) } • { V(I) } = 0. 


( 2 . 2 - 6 ) 


at each of the N control points. 
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Then, 


I q(I) + J2 ^ { "W } ‘ { } q(J) = (2 ‘ 2 " 7) 

m 4r r (IfJ) 

1=1 = - { n(I) } • { v w + y v (I) } 


2.2.3 Numerical Technique “* ‘ 

The system of N simultaneous equations for the unknown source 
strengths q(I) is solved using the Gauss-Seidel iterative technique. There 
were no problems with the convergence as long as the size of panels varies 
smoothly. Hess and Smith (Ref. 2.2-3) point out that the Gauss-Seidel 
method, which uses the improved values in the iterative scheme as soon as 
they are computed, always converges faster than the point Jacobi method, 
which obtains the new approximation entirely from the values of the 
previous iteration. 

2.2.4 Velocity Components in the Propeller Plane 

Jumper's code calculates the velocity {V} at a point {xp} in the 
propeller plane in the body reference frame 



V 1 

X 

( V ] D = 

V 

l * JB 

y 

b 2 J 


where the x-axIs is fixed with the body pointed forward out the nose, the 
y-axis points out the right wing and the z-axls points down. This 
calculation is made after convergence of the Gauss-Seidel iteration scheme 
to solve the linear set of equations. The velocity components required are 
in cylindrical coordinates in the plane of the propeller. To transform 
from the body axes to the propeller blade frame, first rotate about the z- 
axis through the right-thrust angle then rotate about the new y-axis 
through the downthrust angle-ag, and finally rotate about the x-axis 
(rotational axis of the propeller) through the angle -j»‘. This is 
represented by 

{ y } PB * 4W'} l 2 (-« d ) i 3 %) { y } B 
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cosa D cos p ft I -s1n^ R I 

cosao sln^R cosy - slny si nap I cosy cos/Jr I 
slny cosap si + cosy si nap I slny cos/Jr I 

-si nap cos/?r 

-cosy si nap sIo/Jr - slny cosao 
-slny si nag sln^R + cosy cosao 


( 2 . 2 - 8 ) 


The axial, tangential and radial velocity components (V£, Vg, Vr) are 
calculated in subroutine VPROPS. To these velocity components we must add 
(or subtract) the rotational velocity components V$r = HR where Q is the 
rotational velocity in radius per second and R is the radial distance from 
the rotational axis to the point of interest in the propeller place. 

2.2.5 Options and Limitations 

When the body /wing combination has a plane of symmetry, the propeller 
has no side thrust angle and there is no sideslip, the computational 
efficiency can be Improved by exercising the symmetric input option. Then, 
only points on the left half of each cross section need to be input. The 
right side panels are mirror Images of those on the left and the number of 
equations to be solved is reduced by a factor of two. 

The boundary conditions at panels representing Inlets or outlets are 
relaxed such that the normal velocity Is specified to be some fraction of 
the freesteam velocity. In this way, cooling flow to the engine can be 
modeled. This aspect of the code was not exercised for this study although 
it is built into the code. Guidelines developed by Jumper (Refs. 2.2-1 and 
2.2-2) should be used if this option Is needed. 

The code is written for incompressible potential flow. If the 
freestream Mach number is large enough, the axial direction should be 
stretched according to the Prandtl-Glauet rule 


rrn? 

oo 

where M« is the freestream Mach number and X is the transformed axial 
coordinate. However, it would probably only make sense to make this 
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transformation for bodies at zero angle of attack. This transformation is 
not Incorporated into the code and would have to be made by hand. 

For convergence of the Gauss-Seidel integration scheme it Is suggested 
that the panel size change smoothly. That is, don't have large panels next 
to small panels. Also, the panels near the plane of the propeller have the 
most influence on the velocities there. Therefore, the paneling in this 
region should be considered carefully. 


2.2.6 Input Parameters 

The input parameters required by the aircraft flow field module are 
described In Section 3.4 of this manual. Some of the Input parameters have 
been modified compared to the original revision of the JUMPER program, 
while a few have been added. Some of the variable names have also been 
changed to allow compatibility with the other modules. For Instance, the 
sideshlp angle Is now called YAW in the input Instead of BETA, which might 
be confused with propeller twist angle. The propeller plane definition has 
been changed from the original, so now the number of azimuthal stations 
NAZIU Is now an input parameter Instead of DPSI, angular spacing. 

Two parameters that have been added are RPM, the rotational speed In 
revolutions per minute and XREF, a scaling parameter. The rotational speed 
is used with the Inflow velocity to give a first estimate of the total 
velocity at a point In the propeller plane. Then, using the transforma- 
tion matrices from the pitch change frame to the local frame, L|_,PC. we can 
find the local angle of attach a, from the local velocity components 





+ ~rot } 


and 


a = tan 


-1 


r !x 


The scaling parameter XREF is useful when the coordinates of the body 
elements need to be scaled up or down without having to reenter the 
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coordinate data. The current Input coordinates are all multiplied by XREF 
to obtain the required coordinates. Therefore, for example, Coordinates of 
the model can be used for full scale calculations using the XREF Scale 
factor. 


In the present version of GAPAS the number of Inlet and outlet panels 
are defined to be zero (NINFLO = 0). For non-zero NINFLO, the panel Index 
INDEX, and flow rate, FLRATO, need to be specified. These are not 
Implemented In the current revision of GAPAS. Therefore, do not attempt to 
run the program with non-zero values for NINFLO. 


2.2.7 Subroutine Descriptions and Call inq/Cal led Routines 

The aircraft flow field module contains the subroutines described 
below. For a detailed description of the program Implemented see Jumper 
(Refs. 2.2-1 and 2.2-2). 

JUMPER (PROP) - Main program to set up influence coefficients and solve for 
velocity components in the plane of the propeller. Calls 
to subroutines NPUT, VCOMP, WGEOM, PANEL, COEFIC, SOLVE, 
COFSYM, SOLSYM, VELOCI, VPROPS. 

INPUT - Subroutine to read and verify the Input data. Called by 

JUMPER. 


VCOMP 

WGEOM 

PANEL 


COEFIC 


SOLVE 


- Subroutine to compute the components of the freestream 
velocity. Called by JUMPER. 

- Subroutine to establish the geometry and strength of the 
wing horseshoe vortex. Called by JUMPER. 

- Subroutine to generate the surface panels. For a symmetric 
body, the left half of the body Is Input and the right half 
is generated by mirror image, otherwise the entire body is 
input. Called by JUMPER. 

- Subroutine to set up the system of linear equations to be 
solved used for a fully three-dimensional body. Called by 
JUMPER. Call to subroutine WINGV. 

- Subroutine using Gauss-Seidel iteration scheme to solve the 
system of equations. Called by JUMPER. 
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COFSYM 

SOLSYM 

VELOCI 

V PROPS 

WINGV 

VORTEX 


- Subroutine to set up the linear equations for the left half 
of the body - used for bodies with a plane of symmetry. 
Called by JUMPER. Call to subroutine WINGV. 

- Subroutine to solve the set of equations when the body is 
symmetric using Gauss-Seldel Iteration. Called by JUMPER. 

- Subroutine to compute the body -panel surface velocities and 
pressure coefficient. Called by JUMPER. Call to subroutine 
WINGV. 

- Subroutine to compute the velocity components in the plane 
of the propeller. Called by JUMPER. Call to subroutine 
WINGV. 

- Subroutine to calculate the components of velocity induced 
at a point by a horseshoe vortex. Called by COEFIC, 

COFSYM, VPROPS. 

- Subroutine to calculate the velocity components induced by 
a straight line vortex element using the Biot-Savart Law. 
Called by WINGV. 
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2.3 AERODYNAMIC PERFORMANCE MODULE 

The primary aerodynamic performance analysis procedure and computer 
code selected for Inclusion In GAPAS Is that developed by Chang and 
Sullivan (Refs. 2.3-1 through 2.3-3) (the resulting computer code Is called 
the Chang-Sulllvan code). 

2.3.1 Problem Definition 

The problem addressed by the Chang-Sulllvan methodology is that of 
calculation of the performance of a propeller of arbitrary blade shape. In 
addition, methodology is developed to study the performance of propeller 
proplets that are designed to Improve propeller efficiency. 

2.3.2 Method of Solution 

The solution methodology utilizes the vortex-lattice method which 
approximates a lifting surface and Its wake by a discrete vortex lattice 
system (Ref. 2.3-2). In the Chang-Sull ivan methodology, the vortex-lattice 
method is extended to accommodate a general blade shape and to include 
viscous and compressible drag in the thrust, power, and radial force 
formulation. 

The propeller is considered to be a thin blade of arbitrary planform, 
rotating with a constant angular velocity about a common axis In an 
unbounded fluid. The presence of solid boundaries. Including the hub, Is 
ignored. Since the propeller blade Is assumed sufficiently thin, Its 
presence In the fluid can be represented by a distribution of horseshoe 
vortices lying In the chord plane of each blade. There are M vortex 
lattices assumed along the blade radius, each having a constant circulation 
r i. Steady flow conditions are assumed, so that the circulation is only a 
function of location along the radius. 

The vortex wake of the propeller is assumed to be a constant pitch and 
diameter helix, since the induced velocity is small compared with the 
resultant velocity of the propeller, and there is no force existing In the 
radial direction on a helical surface. This assumption, which is 
coincident with Goldstein's helical vortex model, dispenses with the 
essential difficulty in lifting-line theory that the induced velocity and 
the geometry of the trailing helical vortex sheet are mutually dependent. 
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2.3.3 Blade Geometry 


As shown In Figure 2.3-1, a Cartesian coordinate system (x,y,z) 
originates from the center of the hub. The x axis Is defined as passing 
through the propeller blade, the z axis pointing In the positive downwind 
direction, and the y axis completes the right-hand system. The propeller 
Is modeled with a single lifting line at the quarter chord of each blade 
and a set of control points along the three-quarter chord line. The 
propeller is assumed to have K blades. An Index p Is assigned to each 
blade, where p ■ 1, 2 K. The coordinates of the control points can be 

calculated by 


YCj 


ZC 4 


XC, 


(YN j + YN j+l )/2 + 
(ZNj + ZN j+1 )/2 + 



COS 

COS 


where 

(XCj, YCj, ZCj) = control points of the vortex lattice element j 

(XN^, YNi , ZN-j ) = nodal point 1 of the vortex element on the 1/4-chord 

line 


/Jj = the angle of pitch 

Cj = mean chord of the vortex element 

rj = radial distance of the control points. 
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PROPELLER BLADE 



Figure 2.3-1. Propeller Coordinates System 
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With regard to multiple blades, we need to define a blade difference 
angle, 0 p = f* (p-1), P = 1. 2 — K, and p = 1 Implies the principal blade. 

A diagram showing one element In each of a four blade propeller Is given In 
Figure 2.3-2. 

2.3.4 Governing Equations 

With the relevant assumptions of the preceding sections, the propeller 
blade is replaced by a single swept bound vortex, placed at the 1/4-chord 
line, and helical trailing vortex lines, which are determined by the 


following equations: 


x = p cos d 

(2.3-1) 

y = p sin 9 

(2.3-2) 

Woo 

Z = hs e 

(2.3-3) 


where 

u = angular speed of the propeller 
R = radius of the blade 
p = radius of the helical vortex line 
9 = angle of rotation 

All the length quantities x, y, z, and p are nondlmenslonallzed with 
respect to the propeller radius R. The velocity field Induced by the 
vortex lines is obtained by the Biot-Savart law (Ref. 2.3-4). 


v_ _I_ 

V« " 4tRV 

OO 


00 


Sxd£ 
.0 ifti 3 


(2.3-4) 
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(*T' V T- z t) 



Figure 2.3-2. Vortex Lattice Elements for a Four-Blade Propeller 
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where 

v = (u, v, w) Is the Induced velocity at a reference point Pj (x, y, z) 
T = circulation of each element, ft/sec 
V* = free stream velocity 

ft = distance from a reference point of the propeller to a point on 
the vortex line 

d£ = an elemental length of a helical vortex line vector 
Now let the following equations 


X' = rj cos^ 

(2.3-5) 

Y' = rj sin^ 

(2.3-6) 

z ' = z j 

(2.3-7) 

represent the coordinates of the control point where the induced velocity 
is sought. Then, by substituting Equations (2.3-1) through (2.3-3) and 
(2.3-5) through (2.3-7) into Equation (2.3-4), we obtain 

t r 5 x & 

v . ' 4,RV . Jo liSi 3 



where 


ft - 


A 

( p cos e - rj cos^) i + (p sin 8 - 


r j sin *> j + S 6 



The cross product ft x dJ is given as follows: 
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Then the Induced velocities In the x, y, and z directions are 




(2.3-10) 



The velocity components Induced at the reference point by the bound 
vortex can also be obtained by applying the Biot-Savart law. The results 
are derived in Reference 2.3-2 as 

r ■ dr C(Y L -V)(Z T -Z L ) - <Z L -Z')(Y T -Y L )} I « dv; fub 

00 oo 

f - dir KZl-z'KXt-Xl) - (X L -X')(Z T -Z L )} ( 2.3-11) 

00 00 

f ■ dr «X L -X')(Y T -Y L ) - (Y L -Y')(X T -X L )} i = dv; FWB 

00 00 


where 

t 1 [ a+b b 

' ac - bb [&2b^ C 

a = (X T -X L ) 2 + (Y t -Y l ) 2 + (Z T -Z L ) 2 

b = (x t -x l ) (X l -X<) + (Y t -Y l )(Y l -Y') * (Z T -Z L ) (Z L -Z ■ ) 

c = (X L -X') 2 + (Y l -Y') 2 * (Z L -Z') 2 
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and X|_ f Xj, Y|_, Yj, Zl, and lj are coordinates of the vortex elements at 
the 1/4-chord line. 

For a multiple blade propeller they are represented by: 

X|_ = p-f cos ( 9 + 0 p ) = XN-j 
X T * P1+1 cos ( 9 + e p ) = XNj +1 
Y L = pi sin {9 + 0 p ) = YN-j 
y T = P1+1 sin ( 9 + 0 p ) = YN-j+i 

Z L - ZNi 


Zj = ZN i+1 

2.3.5 Boundary Conditions 

The condition of zero velocity normal to the chord plane needs to be 
satisfied at the control points on the blade. The resultant velocity at an 
arbitrary point is the vector sum of free stream velocity Vo#, the induced 
velocity (u,v,w), and the rotating velocity wr: 

v = (u-wrsin 7 ) 1 + (v+wrcos 7 ) j + (w + V w ) k (2.3-12) 

where the angle 7 is as shown In Figure 2.3-2. Let the surface normal of 
each vortex element be represented by 

n = n x j 1 + n yJ j + n 2j k (2.3-13) 
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< 4 - 


By substituting Equations (2.3-12) and (2.3-13) Into the boundary condition 
• n = 0 at the control points one obtains: 


M M * 


n yj + 


(t) n 


zj 


r r V 

fr] Ir 1 s1n *3 * n xj ' ^ cos * "yj 


- n 


zj 


(2.3-14) 


where 


\j ■ (YNj^-YCjHZNj-ZCj) - (ZNj^-ZCjHYNj-YCj) 

n yj = (ZNj, r Z C j) (XNj-XCj) - (XNj^-XCjHZNj-ZCj) (2.3-15) 

"zj ’ (KNj.l-XCjHYNj-YCj) - (YNj^-YCjHXNj-XCj) 


The induced velocity at each control point is made up of the velocity 
components induced by the helical vortex lines and the bound vortex lines: 




M I\ 

S FU u 


h 


m r, 

w 4xRV « FViJ 


Hi 

v_ 


i 


M 

S 4?RV m 

i =1 * 



(2.3-16) 


Substituting Equation (2.3.15) into Equation (2.3-14), the boundary 
condition at the control point j is 
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m r 

ji* 4^ [(FU 1j )n xj + (FV 1j )n yj + 


ff](r]( S,n »J • "xj - C « «i • n yj) 


(2.3-17) 


- n 


zj 


FU ij» FV ij» PWlJ are called influence coefficients, and are given by 

FU U ' FUH mj - FUH ij + FUB ,.j 

FV ij = FVH i + i,j - FV Vj + ™,.j 

™U ' - ^l.j + ™1,j 

2.3.6 Detailed Solution Methodology 

The components of the influence coefficients are found by Equations 
(2.3-8) through (2.3-11). Therefore, the application of the vortex lattice 
method consists of first calculating the influence coefficients and then 
solving the system of equations (2.3-17) to find the circulation Ti/4jrRV«. 
Once the circulation is known, the force on each element is calculated by 
the Kutta-Joukowski law: 


F t = P v x df 1 (2s) (2.3-18) 

In which the induced velocity Is referred to at the midpoint of each vortex 
element on the 1/4-chord line. 
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2.3.6. 1 Thrust Coefficient 

Thrust Is the propulsive force produced by the propeller. Thrust 
coefficient defined by 


C 


T 




where 

T = thrust force, lb 

p = air density (0.002378 slug/ft 3 at sea level at standard conditions) 
n = rotating speed, revolutions/sec 
D = diameter of the propeller, ft 

The aerodynamic force acting on each element of length 2s of the propeller 
is obtained as follows: 

f can be represented by 

(XH U1 - XV T H (YN U1 - vy J + (ZN m - zy l |r| #) 

* “ 2s 

By substituting Equations (2.3-12) and (2.3-19) into Equation (2.3-18), one 
obtains 

(Fx) L = /jr[(v+wrcos 7 ) (Z T -Z L ) - (V w +w) (Y T -Y L )] 

(Fy) L = /3r[(V 00 +w)(X T -X L ) - (u-wrsin 7 )(Z T -Z L )] 

(Fz) L = pr[(u-wrsin 7 ) (Y t -Y l ) - (v+wrcos 7 ) (X T -X L )] 
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/>r 1 (v+wrcos 7 ) (2s) 


1/2 C i (2s) 



The drag force 



r c d 

Fy = pT (w+Vj (X T -X L ) - (u-wrs1n 7 )(Y T -Y L ) + (v+«rcos 7 ) (2s) 

r C. 

Fz = pT (u-«rsin 7 ) (Y T -Y L )-(v+wrcos 7 ) (X T -X L ) + ^ (w+Vj (2s) 

The thrust force on each vortex element is in the negative Z-di recti on, 
i .e. , T = -F z . 

T is nondimensional ized by The thrust loading is obtained by 



The thrust coefficient of the propeller is calculated by integration 
of the thrust loading along the blade radius, using the equation 



2. 3. 6. 2 Power Coefficient 

By analogy with the last section, the power coefficient can be 
derived. Let Q-j be the aerodynamic torque on a blade element. 

• F (h • r i 

where 

F S1 = F y1 * cos 7 * F xi ' s1n 7 
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The power coefficient Cp of each blade element Is defined by 


and 




where 

c .J!l 

«1 ,n 2 D 5 

By considering the drag effect, the power loading Is determined by 
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2. 3. 6. 3 Radial Force Coefficient 


The propeller blade may be shaped In a variety of ways in modern 
design technology for energy saving purposes. A force may exist in the 
radial direction in any part of the blade for complex blade shapes. The 
force In the radial direction is represented by 

Fp * Fx • COS 7 + Fy • sin 7 


In nondimensional form: 



and the radial force coefficient is determined by 
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2.3.7 Numerical Techniques 


2. 3. 7.1 Convergence Analysis 

The Integral expressions of the Induced velocities derived In the 
previous sections cannot be solved by analytical means. While Lamb (Ref. 
2.3-5) has given an expression for a single Infinite helical vortex in 
terms of Bessel functions, the difficulty of the evaluation of the 
principal value of an Infinite integral along the blade makes the use of 
this method prohibitive. 

When the induced velocity integral is solved numerically, two 
questions will naturally arise: ( 1 ) where should we truncate the 

integration, and ( 2 ) what will be the convergence characteristics if we 
truncate the integral at an upper integration limit? These two problems 
can be resolved by error analysis which is presented in this section. 

In numerical analysis, error can be defined as: ( 1 ) truncation error, 

and (2) integration error. The former results from the truncation of 
integration, and the second comes strictly from the numerical Integration 
formula. 

Before performing the analysis, it is advisable to Investigate the 
nature of variations of the Integrands in the Integral expression, 
corresponding to different values of 8 . Computer subroutines denoted by 
FUHINT, FVHINT, and FWHINT are written for calculating the integrands of 
the integral for estimating the induced velocities of u, v, w, 
respectively. The calculations are based on the SR-2 propeller at J = 

3.06, and £ 3/4 = 60°. The results of FUHINT are presented in Figures 2.3-3 
and 2.3-4. Similar results are obtained for FVHINT and FWHINT. A general 
feature of these results is that drastic changes of FUHINT, FVHINT, or 
FWHINT versus the angle 8 occur in values of 8 < 0.4 radian, which 
corresponds to 0.0636 revolution. At 8 = 20 radians, FUHINT = -0.00030, 
FVHINT = -0.00070, FWHINT = 0.00001. Values of the integrands FUHINT, 
FVHINT, and FWHINT, at different revolutions are presented in Table 2.3-1. 

As Indicated by these results, the computer program of integration 
should be well programmed, and relatively small intervals should be used to 
guarantee the desired accuracy. 
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Table 2.3-1. Values of FUHINT, FVHINT, and FWHINT at Different 
Revolutions of Integration 


Number of 
Revolutions 

FUHINT 

FVHINT 

FWHINT 

0.5 

0.03143250 

0.02303523 

0.00709475 

1.0 

-0.00854547 

0.00014987 

-0.00004620 

1.5 

0.00359349 

0.00082761 

0.00025488 

2.0 

-0.00206796 

0.00001806 

-0.00000558 

2.5 

0.00129113 

0.00017642 

0.00005432 

3.0 

-0.00090924 

0.00000527 

-0.00000163 

3.5 

0.00065769 

0.00006389 

0.00001967 

4.0 

-0.00050871 

0.00000219 

-0.00000068 

4.5 

0.00039744 

0.00002996 

0.00000922 

5.0 

-0.00032452 

0.00000111 

-0.00000035 

5.5 

0.00026585 

0.00001637 

0.00000503 

6.0 

-0.00022488 

0.00000063 

-0.00000020 

6.5 

0.00019024 

0.00000991 

0.00000304 

7.0 

-0.00016496 

0.00000039 

-0.00000012 

7.5 

0.00014283 

0.00000644 

0.00000198 

8.0 

-0.00012615 

0.00000026 

-0.00000008 

8.5 

0.00011116 

0.00000442 

0.00000135 

9.0 

0.00009959 

0.00000018 

-0.00000005 

9.5 

0.00008896 

0.00000317 

0.00000097 

10.0 

-0.00008061 

0.00000012 

-0.00000004 
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2. 3. 7. 2 Truncation Error 


The truncation error can be estimated at a large value of 9 of 10 
revolutions. Since iftl Is In the denominator, we then approximate IRI by a 
small value of \h for large 9 = 0 U - For lar 9 e values of 9, can be 

neglected for « 9 U . The value of 2 pr$ cos (9-f) Is approximated by 

2 />rj , which gives less contribution to the value of the denominator. That 

is 


p 2 + r 2 - 2 pr^ cos (0-f) = 
/ + r j 2 - 2 r j - 


= 0 corresponding to the lowest contribution of those terms. We then 
obtain the result: 


> wR 9 


The numerator of Equation (2.3-8) is 


Nu = 




p sin 9- r. sin ^ 

J 


z i 


MJu R 

00 


pcos9 


The approximation principle is to find a larger value of Nu based upon a 
large value of 9. In this case 


Nu 
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The error for Is then obtained by: 
*00 


t < t&t. 15 u J, 


dg = -r 

(V w /wR) 2 g 2 4*MJVJuR) Z 



9 


u 


For K = 8 



For the SR-2 propeller, 


T ) 

4tRV 

00 J 


max 


0.03, J 




= 3.06 


= 0.00403 


This Is a very conservative figure due to the approximation of the 
numerator and the denominator of the Integrand. 

The truncation error of j- can also be obtained following the same 
line as above. 


v 

v „ 


4tRV 


J °n^l 


'V 


-p cos fl+r.. cosjj- [fl- 


-ii 

M 


^]/j sin gldg 


i fir 


(2.3-9) 


thus the truncation error is the same as . 

v oo 
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The truncation error of is 



The truncation errors estimated above represent the upper bound of the 
error, based upon = 10 revolutions. This fact comes from the 
approximation principle employed. These values are too conservative to be 
used in the application, but they give us a general idea about the error of 
truncation. 

2. 3. 7. 3 Error of Integration 

The error of integration is usually affected by the selection of 
spacing, the degree of interpolation polynomial, and the location of the 
base points. The first degree polynomial results in the trapezoidal rule, 
which is familiar in numerical analysis: 

3 

t N, 1 = Ja f(x)dx = iS T 1 Cb)] - f ({), X 0 < (< X r 

where - ^~a) . f» (£) -j s the integration error, which will decrease by a 
factor of 1/2 3 as the interval of h is halved. While higher order formulas 
could give smaller error terms, a low order integration formula is usually 
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preferred with successively subdividing the Interval of Integration and 
using the formula separately on each subinterval. One routine of automatic 
integration Is called CADRE, which Is based on successively interval 
halving and Romberg Integration (Ref. 2.3-6), which Is described as 
follows. 

Let f(x) be integrated In an interval [a,b]. The general formula for 
trapezoidal rule (Reference 2.3-6) is 


T 


N,1 


1 

2N 


T N-1,1 


(b-a 

N- 


2 N 

1 f 

1 = 1 

A1=2 


a + 


b-a 


for N=l,2, — N. 


A sequence of To,l. T l,lr T|\| ( i is then generated. By applying 

Richardson's extrapolation formula, 



J-l- 


N+1J 


■r T N.,1-l 


J-l 


to each pair of the adjacent elements of the sequence, Bauer, et al . as 
cited in Reference 2.3-6, showed that each of the sequence Tf^j for j = 1, 

2, converges to the true integral value with an increasing number of 

N. 


The function CADRE returns an approximate value of the true value of 
the integral f(x)dx, which Is denoted by INT In the function program. 
The requirement that must be satisfied Is that the absolute value of (INT - 
CADRE) should be less than the maximum value of absolute error AERR or the 
relative error RERR absolute (INT). 

In this scheme, the program integral is calculated as the sum of 
integrals over suitably small subintervals, and the absolute and relative 
errors are found. If the error satisfies the requirement, the value of 
integration is accepted, otherwise the subinterval is halved. 
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In the Chang-Sulllvan code, the function CADRE is used for performing 
the Integration along the helical vortex lines. Table 2.3-2 represents the 
results of the output by using CADRE for the NASA SR-2 propeller for 
different numbers of revolutions. It Is clear from the table that the 
thrust coefficient, the power coefficient, and the efficiency are all 
accurate to the hundred thousandth digit after five revolutions. 


Table 2.3-2. Values of C T , C p , and >7 at Different Revolutions of 
Integration SR- 2 , J = 3.06, p - 60 


Number of 
Revol utions 

Thrust Coefficient 

CT 

Power Coefficient 
C P 

Efficiency 

V 

1 

0.065469 

0.221508 

0.904411 

2 

0.065430 

0.221401 

0.904321 

3 

0.065423 

0.221380 

0.904305 

4 

0.065421 

0.221372 

0.904300 

5 

0.065419 

0.221369 

0.904297 

6 

0.065419 

0.221367 

0.904296 

7 

0.065418 

0.221366 

0.904296 

8 

0.065418 

0.221365 

0.904295 

9 

0.065418 

0.221365 

0.904294 

10 

0.065418 

0.221364 

0.904294 


2.3.8 Dictionary of Input Variables 

A list of the input labels is shown below. Labels with no units 
specified represent nondlmensional quantities. 

Input Labels Description 

ADV Advance ratio, V/nD, where V is the advancing 

velocity, n the rotating speed, and D the propeller 
diameter. 

BETA3Q Design blade angle at 0.75R of the blade (degree). 

BETAST Blade angle at 0.75 R for the current run (degree). 

BET AW Cant angle of the proplet. Proplets are excluded by 

setting BETAW = 0.0 and MPR0P = M, where M is the 
number of the horseshoe vortex lattice elements 
(degree) . 
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BLADE 

CE 

DECLE 

DELHT 

HT 

HOBE 

ID2 

M 

MPROP 

N 

OR 

RBLADE 

RHUB 

SA 

ALEA 

SLO 

TITLE 


Number of propeller blades. 

Chord Length at each blade station (Inch). 

Design lift coefficient at each blade station. 

Distance from propeller rotation axis to blade 
spanwise reference location (Inch). 

Spanwise location for blade section characteristics 
(Inch) . 

Thickness ratio of the airfoil section at each blade 
station. 

Control parameter for the Input of Inflow velocity of 
propeller. If ID2 = 1, the inflow velocity is 
uniform, and ID2 / 1, nonuniform. 

Number of vortex lattice elements. 

Number of blade element on which the proplet is 
installed. 

Number of blade stations where the blade geometry is 
input. 

The distance from the airfoil mean line at 0.75 chord 
position to the chord line. 

Propeller radius. 

Radius of the propeller hub. 

Blade angle (degree). 

Blade leading edge location (inch). 

Slope of the mean line at 0.75 chord relative to the 
chord line. 

Title input. 


01-168-86 


2-66 



XM 


Flight Mach number. 

VN Propeller Inflow velocity at element endpoints 

(nondlmenslonal Ized by flight velocity). 

Input Cards and Formats 


Card No. 

Labels 

Formats 

1 

TITLE 

(8x, 12A6) 

1A 

RPM 

(HO) 

2 

M , RHUB , RBLADE, BLADE , ADV , BETA3Q , BETAST , BET AW 

(110, 7F10.5) 

3 

MPROP , ICAMB , ID2 , XM 

(3110, F10. 5) 

4 

DELHT.N 

(FIO.4,110) 

5 

HT(I) ,ALEA(I) , CE ( I) ,SA(I) ,H0BE(I) ,DECLE(I) , 
I = 1,N 

(6F10.4) 

5+N 

SLO.OR 

(2F11.5) 

6+N 

VN ( I ) 

I = 1 ,M 

(8F10.4) 

2.3.9 Program Capabilities; User Options 


The capabilities of the Chang-Sullivan methodology are that it 
calculates propeller aerodynamic performance for straight and swept blades, 
including proplets. In addition, it includes the effects of 
compressibility in the drag coefficient, cascade effects (for thin blades), 
and includes nacelle effects by treating the nacelle as an infinite 
cylinder. There is, however, no provision for supersonic tip effects or 
correction fr finite blade-thickness effects. User options are the 
inclusion or exclusion of proplets and the selection of uniform or 
nonuniform inflow velocity at the propeller plane. 
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2.3.10 Program Validation 


The program has been validated by comparison with experimental data. 
Verification calculations carried out by TRW for the SR-3 propeller at 
advance Mach numbers of 0.8, 0.45, and 0.2 are shown In Figures 2.3-5, 
2.3-6, and 2.3-7, respectively, In which power coefficient and propeller 
efficiency are shown as functions of advance ratio. Note the excellent 
agreement for the Mach 0.8 and 0.45 cases, and fair agreement for the Mach 
0.2 case. The fall-off in accuracy at the lower advance Mach number is 
most probably due to flow separation effects in calculations at the higher 
blade section angles of attack at this Mach number. Extensive comparisons 
of calculations with data, and of proplet effects, are also given in 
Reference 2.3-1 for the SR-1, SR-2, SR-3, NACA 109622, and Cessna 172 
propellers. Comparisons of power coefficients and efficiency for two- 
bladed propellers show good agreement. For propellers having more than two 
blades, the underprediction of induced effects results in an overprediction 
of ideal efficiency, however. 
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ADVANCE RATIO. J 
Figure 2.3-7. 


— WIND TUNNEL TEST DATA 
G CALCULATION (CHANG-SULLIVAN COOE) 



3.4 2.8 3.0 3.2 3 . 

ADVANCE RATIO, J 

Aerodynamic Performance of SR-3 Propeller 
M 0 = 0.80, /J.75R = 60.95° 



2.4 AIRFOIL LOADING MODULE 

2.4.1 Airfoil Analysis Method: TRANSEP 

A numerical technique for analyzing transonic airfoils Is presented. 
The method employs the basic features of Jameson's iterative solution for 
the full potential equation, except that cartesian coordinates are used 
rather than a grid which fits the airfoil, such as the conformal circle- 
plane or "sheared parabolic" coordinates that have been used previously. 
Comparison with previous results shows that It Is not necessary to match 
the computational grid to the airfoil surface and that accurate results can 
be obtained with a cartesian grid for lift in supercritical airfoils. 

The first practical numerical technique for solving two-dimensional 
steady transonic flows was developed by Murman and Cole (Ref. 2.4-1) for 
the small perturbation equations in cartesian coordinates. The essential 
features of this technique were the utilization of retarded (upwind) 
differences in regions of supersonic flow, central differences in subsonic 
zones, and the application of a far-field boundary condition at a finite 
distance from the airfoil. The surface f 1 ow-tangency boundary condition 
was applied on the horizontal axis, consistent with the small disturbance 
approximation, and the resultant finite difference equations were solved 
iteratively by numerical relaxation. Shock waves occurred naturally in the 
course of solution as steep compressions smeared over several mesh points, 
and accurate results were obtained for slender airfoils. 

This technique was subsequently extended to the complete potential 
flow equations and the exact boundary conditions by Garabedian and Korn 
(Ref. 2.4-2), Steger and Lomax (Ref. 2.4-3), and Jameson (Ref. 2.4-4) and 
was successfully applied to thick, blunt-nosed, and aft-cambered airfoils. 
In these investigations, the edge of the computational coordinate system 
was closely matched and aligned with the airfoil surface in order to 
accurately represent the surface flow-tangency boundary condition. For 
example, Steger and Lomax used a curvilinear wraparound system, while 
Garabedian and Korn and also Jameson conformally mapped the exterior of the 
airfoil onto the interior of a unit circle with infinity corresponding to 
the circle origin. Jameson also used a parabolic type system (Ref. 2.4-4) 
in another version designed to handle supersonic freestreams. These 
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transformations had the advantage that near the body they aligned the 
coordinates with the flow, which Is particularly advantageous In the 
leading edge region where body slopes and vertical velocities can be large. 
Unfortunately, such transformations introduce into the differential 
equation many, sometimes complicated, transformation derivatives. 

Now in order for any backward difference scheme at supersonic points 
to work properly, the coordinate along which the backward differences are 
taken must be closely aligned with the flow direction. This alignment is 
very difficult to achieve with mapped coordinates when the freestream Mach 
number is high or the supersonic zone is large. On the other hand, 
improper alignment at supersonic points can lead to situations where the 
velocity component in each coordinate direction is subsonic, that is 

U 2 , V 2 < a 2 < U 2 + V 2 (2.4-1) 

This situation not only can lead to numerical instability but also can 
impart to the finite difference equations an incorrect zone of dependence. 
To remedy this problem South and Jameson (Refs. 2.4-4 and 2.4-5) have 
Introduced a rotated finite difference scheme which simulates a local 
rotation to coordinates along and normal to the velocity vector; and, in so 
doing, they have created a scheme that not only has the correct zone of 
dependence but also does not require coordinate alignment with the flow. 

As a consequence of this development, questions arose. Can the full 
potential flow equations be solved for a transonic case in a simple 
cartesian or stretched cartesian system by using the concept of rotated 
differences? If so, what is the accuracy and what are the properties of 
such an approach? In order to answer these questions, the present study 
was initiated. Its primary objectives have been to: 

(1) Develop an analysis program using cartesian coordinates (airfoil 
given, C p and flow field unknown) 

(2) Develop a design program in cartesian coordinates (C p given, 
airfoil and flow field unknown) 

(3) Study the results obtained by such an approach and determine the 
accuracy and idiosyncrasies associated with a cartesian system. 


01-168-86 


2-73 



This section describes the development of, and results obtained with, 
the TRANSEP analysis program. Reference 2.4-6 discusses the design 
program. 

Symbols 


Ai, A 2 , A 3 
a 

a,b 

C P 

C L 

C MLE 

M 

N 

P 

q 

s 

t 

U.v 

x,y 

a 

P 2 

7 

r 

e 

9 

Z'V 

P 

4 

* 

Subscripts: 


b.body 

TE 

i,j 


Coordinate stretching constants 
Isentroplc speed of sound 
Coordinate stretching constants 
Pressure coefficient, (p-p w )/(l /2 p m U» 2 ) 

Lift coefficient 

Coefficient of moment about the leading edge 
Coordinate stretching functions 
Mach number 

Coordinate normal to the streamwise direction 

Pressure 

Velocity 

Streamwise coordinate 
Time 

Velocity component In the x-,y- direction respectively 
Cartesian coordinates 

Angle of attack or coefficient In Equation ( 2 . 4 - 34 ) 

1-M2 or coefficient in Equation (2.4-34) 

Ratio of specific heats or coefficient in Equation (2.4-34) 

Circulation 

Damping coefficient 

Polar Coordinate 

Computational coordinates 

Density 

Potential function, Equation (2.4-3) 

Perturbation potential, Equation (2.4-4) 

Freestream condition 
Body 

Trailing edge 
Grid location 
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d'f 

f.ij.x.y Differentiation, l.e., f x = ^ 

Superscripts: 

+ Value computed by current relaxation sweep 

2.4. 1.1 Problem Formulation 

The exact equation for the potential function for two dimensional 
compressible flow can be written In cartesian coordinates as 

(a 2 - $x 2 )*xx ~ 2$ x*y $ xy + ( fl2 " $ y 2 ) $ yy = 0 (2-4-2) 


where 


* -8* * 

v x dx, XX 


9 2 4 


$ 


a 2 * 


ax 


2, xy axay 


etc. 


If a perturbation potential, <f>, is introduced such that 

♦ = xq»cosa + yq»sina + q«^ (2.4-3) 

where the velocity components are given by 

U = 4 X = qoo(cosa + 0 X ) (2.4-4a) 

V = 4 y = q»(sino + ^y) (2.4-4b) 

then the governing equation for the perturbation potential becomes 

(a 2 - U 2 )^xx ” 2 *JV^xy + ( a2 ” V 2 )^yy = 0 (2.4-5) 

with 

* 2 ■ a * 2 - ( ] [ U 2 + V2 - q.2 ] (2-4-6) 


The pressure coefficient at any point is given by 
P 

TO 

'P 1 = 7 M « 


r _ p - P ” _ _J _ 2 /[ 1 + M 2 

C - _ U 2 " 7M 2 U 1 2 « 


1 - 


U 2 + V 2 


] 7_1 -l} (2.4-7) 


The appropriate 


boundary conditions are, at the airfoil surface 



(2.4-8) 
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(2.4-9) 


and at Infinity (Refs. 2.4-2, 2.4-7 and 2.4-8) 

* = fjjF Tarrl 0 9 Tan (0 - a)) 

Where Q Is the polar angle and T Is the circulation determined by the 
change in potential across the Kutta-Joukowski cut at the trailing edge of 
the airfoil , 1 .e. , 

T = (fy=o + - 0y=O") Trailing Edge (2.4-10) 

2.4. 1.2 Numerical Analysis 

Coordinate Stretching 

In the present problem an infinity boundary condition must be applied 
at the edge of the computational grid. It is convenient to transform or 
stretch the original x,y plane to some plane so that the edges of the 
grid correspond t infinity. In this way, Equation (2.4-9) can be 
applied directly. If this is not done, a far-fleld condition (Ref. 2.4-8) 
can be used at the grid edges instead. 

After investigating several possibilities, the coordinate stretching 
represented in Figure 2.4-1 was selected. Here x,y is the physical plane 
and represents the computational plane, and each is subdivided into 
three regions. The stretching is symmetrical about the origin and it is 
given by 


x * x 4 + A 2 Tan[ f (f - £ 4 )] + A 3 Tan [ f (f - £ 4 ) 3 ] (2.4-11) 

in region III and by 

x = f(a + b f2) (2.4-12) 

in region II. The constants a and b are determined by the requirements 

x = x 4 at £ = £ 4 (2.4-13a) 


and 
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Figure 2.4-1. Flow Field Subdivision for Coordinate Stretching 
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(2.4-13b) 


dx 


tA, 


at e = e 4 


The constant A 2 controls the grid spacing In the vicinity of x 4 , usually 
near the leading and trailing edges; while A 3 determines the physical 
location of the grid line adjacent to the grid edge. 

In the y-dlrection the stretching relationship is given by 

y = A!Tan(| rj) (2.4-14) 

where A\ controls the grid size near the airfoil. 

Notice that the stretchings map the infinite physical x f y plane 

-» £ x S » 

-00 £ y ^ 00 

into the finite computational plane 

-(1 + U) * Z * 1 + U 

-1 i ij i 1 (2.4-15) 


where f 4 determines the amount of the computational plane confined to the 
vicinity of the airfoil. A typical grid system is shown in Figure 2.4-2. 

When selecting a stretching, care must be taken to ensure that the 
stretching does not force a physically unrealistic or abnormal behavior on 
the solution. For example, analysis of a compressible doublet Indicates 
that and should decay as 

4 - y" 3 a s y « 

^y -3 

J ~ x as y + * 
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Figure 2.3-2. Typical Grid System (25 x 25) 
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(2.4-16) 


. ~ x“ 2 as y + • 

* x -2 

~ y as y -► « 

In the present system, this type of decay would require that 

^ ~ y _1 as y + « 

•• constant as x + » (2.4-17) 

and this type of behavior is quite permissible. However, with some other 
stretchings such as 17 = tanh(y), the decay indicated by Equation (2.4-16) 
would require that 

tn " * as y ♦ «, rj * 1 (2.4-18) 

In practice, it usually happens that the derivatives in the 
computational plane remain finite, even with the exponential stretchings; 
but this precludes the correct asymptotic decay, and the effect may produce 
stable, convergent, wrong solutions. 

Now as a result of the introduction of coordinate stretching, the 
governing equations should be written In terms of the Independent 
computational variables f and rj. By defining 


f 




(2.4-19) 


Equations (2.4-4) and (2.4-5) become 


(a 2 - U 2 )f(f^ - 2UVfg^ + (a 2 - V 2 )g(g^ = 0 (2.4-20) 


U = q»(cosa + f^) 


V = q»(s1na + fy) 


(2.4-21) 
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Finite Difference Scheme 


As Indicated earlier, at supersonic points In order to avoid 
difficulties associated with nonalignment of the coordinates and the flow 
field a rotated finite difference scheme Is used In the present problem. 

In this approach (Refs. 2.4-4 and 2.4-5) the principal part of the 
governing differential equation can be written In coordinates parallel and 
perpendicular to the local velocity vector, S and N, respectively, as 


1 



^SS + ^NN = 0 


(2.4-22) 


where 

hs ■ ”2 [ u 2 f ( f V{ + 2mq Ui * v 2 s( 9 Vi] 

*NN ' ”2 [ v2f W{>{ + 2UVf 9'{, + u2 9< 9 V,] <2 - 4 ' 23) 

Notice that substitution of Equation (2.4-23) Into (2.4-22) yields the 
governing equation, Equation (2.4-20), and thus, as pointed out by South 
(Ref. 2.4-5), Equation (2.4-22) Is simply a rearrangement of terms which 
exhibits the basic features of a local rotation to the streamline 
direction. 

The basic concept (Refs. 2.4-4 and 2.4-5) of the rotated scheme Is to 
use, at supersonic points, first-order, upwind differencing in both the £ 
and rj directions for all contributions to 0ss an d central differencing for 
all contributions to 0 nn. In th1s manner the correct zone of dependence at 
supersonic points is built into the finite difference scheme. At subsonic 
points, the normal procedure of using central differences for all 
derivatives directly in Equation (2.4-20) is used. Consequently, the 
scheme is second-order accurate at subsonic points and first-order accurate 
at supersonic points. The resulting finite difference equations are solved 
iteratively by using column relaxation sweeping from upstream to 
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downstream. In such a procedure the values obtained during an Iterative 
sweep can be thought of as new values, while those obtained during the 
previous sweep can be considered old values, In this manner, the 

change from one Iteration to the next can be viewed as that occurring 
during some artificial time step, At; artificial time derivatives such as 
$£t and frjt can be considered. Of course, as the relaxation process 
converges, these terms become negligible. 

Various Investigators have used different finite difference formulas 
to represent the derivatives In Equation (2.4-23). For example, Jameson 
(Ref. 2.4-4) and South and Jameson (Ref. 2.4-5) In their finite difference 
formulation used a mixture of old and new values. In this way, terms such 
as ^st and 0Nt were implicitly added to the problem and used to control 
numerical stability. Since It was determined by Jameson (Ref. 2.4-4) that 
additional 0$t needed to be explicitly added to the problem in order to 
ensure stability, It was decided in the present case to use all old values 
in the difference expressions for ^$S and t0 add 0St explicitly. For ^nn, 
appropriate combinations of old and new values were used, causing ^ to 
occur implicitly. It should be emphasized again that and ^$t 9° to 
zero as the solution converges, and hence do not affect the final result. 

Thus the finite difference expressions used in the present formulation 

are: 

For contributions to ^nn w h en 9 2 > a 2 

= ^2 { f 1+l/2^1+l,j " *1j) " f 1-l/2^1j " *1-1, j)} ( 2 - 4 “ 24a ) 

*f tj = J^Erj {*1-1, j “ *1-1, j+1 " *1+1, j-1 + *1+1, j+l} (2.4-24b) 

(9 V » 7 = ^2 { g j+l/2 ( *i,j+l " *ij) " g j-l/2 ( *1j " *1 , j-1^} (2,4 " 24c) 

For contributions to w h en 9 2 > a 2 and V > 0 
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(2.4-25a) 


( f # { > £ ■ ^2 < f 1-l/2 ( #1J ' #1-1, J> ' f 1-3/2 ( #1-l,J " #1-2.J )} 

#{, ’ T&j »1j ' #1-1, j ' #i.J-l + #i-U-i } 
(a#,), * ^2 {g J-l/2 ( #1j ■ #1,J-l' ' g j-3/2 ( #1,j-l " #1,j-2 )} 

where to create stability there is added to the basic equation 
-eAt* . -efAt [Uf . Vfl , ] 

~ Lq **t q *ri tJ 


-ef 


. A^q /2 Wj " *1j " *1.J-1 + 


V (#u - #ii - #Uj * *i- J 


For contributions to ^$S when q2 > a^ and V < 0 


(f Vc = ^2 {f 1-l/2 ( *1j " *1-1, j ) " f 1-3/2 ( *1-l,j " *1-2, j )} 

*ft = A JSj { '*1j + *1-1, j + *1.J+1 " *1-U+1 } 

(g V#7 = ^2 {g j+l/2 ( *ij ' *i,j+l ) “ g j+3/2 ( *1J+l " *i,j+2 )} 
and to create stability there is added 


(2.4-25b) 

(2.4-25c) 


(2.4-25d) 

(2.4-26a) 

(2.4-26b) 

(2.4-26C) 
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-efAt A _ zef fu f 1 — 1/2 f,+ . .+ . . 1 

Af *St " AC lq A£ IHj " Hj ' *1-1, j + *1-1, jj 

+ 5 Kl + #ij + ^i,j+i - 'i, J+ i)] < 2 - 4 - 26d > 

At points where q2 < the expressions are 

(f *^£ = Ap ^ fl+ l/ 2 ^ i+ l.J " (f 1+l/2 + f 1-l/2>- 

+ f 1-l/2*l-l,j} (2.4-27a) 

Uv = *4^ 1^1-l.J-l ' *1-1J+1 " *1+1, j-1 ' *1+1, J+l} (2.4-27b) 

{ %\ * ^ {Wtf.J*! - /j) - 9j-l/2«j - tf.j-l)} < 2 - 4 - 2 ^) 

where the relaxation factor, w, has been Incorporated into the difference 
formulas. 

In all cases, the velocities U and V are represented by central 
differences using old values. When these expressions, Equations (2.4-24) 
through (2.4-27), are substituted appropriately Into Equation (2.4-22) and 
(2.4-23) or Equation (2.4-20), the result Is a tridiagonal system of 
equations that can be solved for the values of on column i. 

Treatment of Boundary Conditions 

There are many ways to approximate the flow tangency condition, 

Equation (2.4-8), at the airfoil boundary. One of the simplest, which Is 
used here, is to generate dummy values of ^ at mesh points Inside the 
boundary such that the usual difference equations can be solved at points 
just outside the boundary. The problem is to develop a scheme for 
providing and updating these dummy values by using the surface flow 
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tangency condition and neighboring values of f In the mesh, with adequate 
accuracy and without creating Instability. 

To accomplish this, we first note that. In the computational 
coordinates, Equation (2.4-8) becomes: 



slna + g b ^ b 
cosa + f b ^ b 


(2.4-28) 


Next a Taylor series about the dummy point (1,j~l) is written (see Figure 
2.4-3) 


\ * Vj-i + c,b ' ’J-'Vj-i * • • ■ 


(2.4-29a) 


*( b s * (, » • ’m’Vm + ' 


(2.4-29b) 


When these are written In finite difference form using second-order 
expressions for and ^ and at least first-order ones for and 
they become (for the upper surface case) 


. ~ 3 * 1 .. 1-1 + 4 * 1.1 ' * 1 J +1 

\ 2A 7 


+ (7 b “ 


* 1 . 1-1 ~ 2 * 1.1 * hu ± 1 


A? 


„ . *i±u=i : 

"b " 2A£ 


(2.4-30a) 


♦<* - «•««* 
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Figure 2.4-3. Relationship Between Airfoil and Grid (Upper Surface) 
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These expressions can then be substituted into Equation (2.4-28) and the 
result solved for a sufficiently accurate ^i,j-i that is in terms of the 
neighboring potentials, body slope, and body position. 

For those situations where the flow at point (1,j) Is supersonic and 
V 1 j > 0, examination of Equation (2.4-25) shows that the difference scheme 
will require a ^i,j-2 values as well as ^^j-i. Thus, in all cases a value 
of ^i,j-2 is determined by extrapolation as 

*1 J-2 = ~^i j + 2 *1,j-l (2.4-31) 

The above procedure for determining the values of the dummy mesh 
points inside the boundary is performed twice for the relaxation procedure 
of column i. First, Equation (2.4-28) is used with l values obtained by 
the previous relaxation sweep in order to obtain old values for the dummy 
points ^-j j_i and j-2* Then, after column i has been relaxed, it is 
used again with as many current values of <f> as possible to obtain new 
values and In this manner, the dummy mesh points will have 

both old and new values just like regular mesh points, and they can be used 
directly in the finite difference formulas without special treatment. 

A similar procedure is used to satisfy the boundary conditions on the 
lower surfaces of the air foil. 

At the edge of the grid the infinity boundary condition given by 
Equation (2.4-9) must be used. In the stretched £,t) system the polar angle 
at the edge of he grid will have he values shown in Figure 2.2-4. Thus, 
the boundary values will be: 

On line AB, 6 = 0, <f> = ^ (-Tan' 1 [£Tana]) (2.4-32a) 

On line BC, 9 = <f> - £ Tan' 1 (/Jcota) (2.4-32b) 

On line CD, 6 = r, f ^ [* - Tan' 1 (/TTano)] (2.4-32c) 
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4. Computational Grid - Infinity Points 
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(2.4-32d) 


On line DE, 9 = |*, $ = S ^ ' Tan_1 ^ cota ^ 

On line EF, 6 = If, f ^ [2t - Tan -1 (/?Tana)] (2.4-32e) 

Boundary values must also be assigned to the singular corner points B, C, 

D, and E since they will be used In the finite difference formula for 
The choice of these values Is somewhat arbitrary since they depend upon how 
the corner points are approached. Fortunately, numerical studies indicate 
that the solution is insensitive to the values selected; and, thus, the 
following have been used: 


_r -i 

Point B, <p = Tan 


fA 

_i M 
A 2 


(2.4-33a) 


Point C 




x - Tan 


-1 


^1 A i 


(2.4-33b) 


Point D, <f> = 


t + Tan 


-1 


ft M 
A 2 


(2.4-33C) 


Point E, <j> = £ |2t - Tan* 1 


ft 


(2.4-33d) 


These assume that the corner points are approached along a diagonal (in the 
£-rj plane) connecting the interior point just inside the corner and the 
corner points 

Using the above finite difference formulas and boundary conditions, 
the governing differential equation can be solved Iteratively by column 
relaxation. For each Iteration, the sweep pattern is from upstream to 
downstream in the region in front of the airfoil, then in the region above 
the airfoil, then below the airfoil, and finally in the portion downstream 
of the trailing edge. The latter region contains the Kutta-Joukowski cut, 
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and the equations are appropriately differenced to give the proper jump in 
the potential. 

2.4. 1.3 Numerical Stability 
Supersonic Points 

The incorporation Into the finite difference formulas of both old, 
and new, ^ + , values and the explicit inclusion of 0$t at supersonic points 
Introduces time-like derivatives Into the equation being solved. Thus, 
during the Iterative process the actual equation at supersonic points is of 
the form 


70 t + 



yss + 2fl ^St " *NN + 2 ^Nt = 0 


(2.4-34) 


Jameson (Ref. 2.4-4) has shown that for numerical stability the 
coefficients must be such that 


7 = 0 


(2.4-35a) 


a 


2 




(2.4-35b) 


Since the ^$t 1s Included explicitly [see Equations (2.4-25d) and (2.4- 
26d)], that a is known, and the p can be determined from the ^nn term. 

By adding and subtracting old values of l to get ^ in terms of old 
values, the time-like derivatives can be Isolated. Thus 
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^NN ' 2 ^Nt = ^NN 



, V 2 f At , f . \ 

“ ^NN ' q 2 A£ 1 -1/2, j 


UVfq At 

n2 


+ ^2" ^ t(g^ t ) iij+ i /2 - ^ v th, 3 - 1 / 2 ^ (2.4-36) 

which In the limit of vanishing step size becomes 

^NN " 2 ^Nt ^NN + q~ [q - f ^t + ^t] (2.4-37) 

where the term in brackets is Hence, from a time-like viewpoint the 

actual differential equation being solved is 





(2.4-38) 


and so 
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(2.4-39) 


7 = 0, a 


eAtf 
2A£ ' 


P ■ 


-VfAt 

qAe 


Thus, from Equation (2.4-35), a necessary condition for stability is 




.a 2 


(2.4-40) 


Notice that this requirement means that, for a fixed value for e, 
numerical instability Is most likely to occur where the local Mach number 
Is large, say immediately upstream of a shock wave. Numerical experiments 
have been conducted to verify Equation (2.4-40), and in most cases 
Instability, if present, does originate from the high Mach number region in 
front of a shock wave. However, the minimum value of e predicted by (2.4- 
40) is usually much smaller than the value actually required in practice. 
This latter phenomena has also been observed by other Investigators using 
time-like damping, and usually the actual value Is only slightly less than 
e max where 




(2.4-41) 


Subsonic Damping 


Since at subsonic points Equation (2.4-20) is used while at supersonic 
points Equation (2.4-22) is solved, there Is the possibility that during 
the Initial Iterative stages that the time-dependent terms of the two 
finite difference equation forms do not match near the sonic line. This 
mismatch possibility can be prevented by adding, to the subsonic finite 
difference equations, a term 


-eAtf 



[Mi a 
if lq f 


, + V g , 1 

£t q y r^tj 


(2.4-42) 


which when q equals a causes the supersonic and subsonic difference 
equations to match exactly. 
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The question naturally arises, however, of what effect Equation 
(2.4-42) has upon convergence and stability away from sonic points. By 
substituting Equations (2.4-27) Into Equation (2.4-20) and Isolating the 
time-like terms, It can be determined that the actual equation being solved 
at subsonic points Is 


r 21 

l a 2 J 


f - f + 


1 2 
a j 


g (a*,), 


J .<£ 

a 2 j 




i.j£ 

a 2 


S? 4t "{t 


. UVfq At , Atf [Uf , + V . 1 = 

* ~T 4£ v - £ ST lq q 9 VJ 


(2.4-43) 


Far away from the supersonic zone and the airfoil, V will normally be very 
small and the effective equation will be 


1 



f (f^ + g (g + 






U 2 1 f^At . eAtf Uf 
a 2l A£ A£ q 



(2.4-44) 


In order to see the effect of the term on t * ie solution behavior 
of this equation, assume 


f = g 

At Af (2.4-45) 

U q 
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and let 


(2.4-46) 


A = 



constant 


Then Eqgatlon (2.4-44) can be modeled as 

A * ££ + V ■ if Pi-*) h * + e # £ t < 2 - 4 - 47 ) 

The convergence behavior of this equation can be studied following the 
approach of Garabedian (Ref. 2.4-4). First, transform from (£,7, t) to 

(C,7. s ) fa y 


s - t + fejr) t (2.4-48) 

and assume solution of the form 0= U(f,7)W(s). Thus, in general, the 
solution to Equation (2.4-47) is 


* - u. ( £ ,,) + I V u 


m=l 


m m 


where W m and U m are eigenfunctions and 


W m = Ce 
m m 


Pml s 


De 

m 


m2' 


and 


p ml,2 


-0 ± [£i - 4aKm 2 ] 1/ 2 
2a 


and C m and D m are the Fourier coefficients. 


(2.4-49) 


(2.4-50) 


(2.4-51) 
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Obviously, the rate of decay of the time terms Is determined by the 
real part of Pn, and the optimum convergence rate will occur when the 
relaxation factor, w, Is such that the radical In Equation (2.4-51) Is 
zero. When It is zero or purely Imaginary, the rate of convergence will be 
determined by 


P 


= zi = 

2a 


2 

-2A^ l w J 
A£ (A + e) 2 


(2.4-52) 


For a fixed relaxation factor, as the damping coefficient, e, Increases, 
the radical In Equation (2.4-51) eventually goes negative; and the error, 

E, due to N relaxation iterations will be of the order 

E = 0 (e‘ pNAt ) (2.4-53) 

Since p decreases as (A + e) - ^, an increase In e from zero to one can cause 
an order of magnitude increase in the number of iterations required for 
convergence. 

From this analysis It can be concluded that the addition of e^st at 
subsonic points significantly decreases the rate of convergence and large 
values of e should be avoided. 

In addition, South has shown by a linear stability analysis that for 
the model equation 


*xx + *yy - £ Wxt - eV 'yt - 0 

that the inclusion of explicit time-like damping in addition to that 
implicitly obtained by the finite difference forms of ^ xx and ^ yy can, in a 
stretched coordinate system, be destabilizing and may cause numerical 
instability, particularly in regions of hard stretching where V is large. 

Based upon these two analyses, both of which have been verified 
numerically, it is believed the specific addition of efct at subsonic 
points should be avoided and that the mismatch in time-like terms near 
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sonic points should be prevented by changing the damping coefficient at 
supersonic points to [M 2 - l]!/ 2 e. 

2. 4. 1.4 Numerical Studies 

In actually carrying out the numerical solution, the parameters Aj, 

A 2 , and A 3 should be selected so that the grid spacing. Ax and Ay, is small 
near the airfoil, and X 4 should be near the trailing edge. The question Is 
how small and how close? See Figure 2.4-5. 

To answer these questions a series of numerical experiments was 
conducted and it was determined that accurate results for lift and surface 
pressures could be obtained when 

s & s ^ (2.4-55) 

In the vicinity of the leading edge. (In the present computer formulation 
the chord c is always unity. The airfoil leading edge is at x = -0.5 and 
the trailing edge at x = +0.5.) No significant changes in lift or surface 
pressures were observed for smaller step sizes as long as Ax was about the 
same magnitude as Ay near the leading edge. However, when Ay was three 
times Ax near the leading edge good accuracy was not achieved until 

“ - , Ay - 3Ax (2.4-56) 

and considerable sensitivity to the value of Ax was observed. In addition, 
the pressure coefficient near the nose exhibited slight oscillatory 
behavior. 

Considerable sensitivity was also observed for the value chosen for 
X4, which essentially determines the first and last grid points on the 
airfoil. For a grid spacing given by Equation (2.4-55), X 4 values of 0.50 
and 0.49 yielded pressure coefficient results that differed by as much as 
10 percent, with the results associated with the 0.5 value being worse. In 
addition, sensitivity to grid spacing was observed in the 0.5 case but was 
minimal in the 0.49 case. Further investigation showed that, if the 
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spacing near the leading edge were reduced to r/c either by using more 
points or by coordinate stretching, good results Insensitive to the X 4 
choice could be obtained even for X 4 values near 0.5. The cause of this 
behavior Is not completely understood. 

Based upon these results and those previously discussed concerning 
numerical stability, It Is believed that accurate solutions can be obtained 
when 


X 4 = 0.49 0.495 

Ax Ay „ £lLE 

c c " c near the leading edge (2.4-57) 

In addition, considering the destabilizing effects of hard stretching, It 
is recommended that whenever possible Ax be kept relatively constant 
between the leading and trailing edges of the airfoil. 

2. 4. 1.5 Viscous Boundary Layer and Wave Drag Correction 

Experimental evidence Indicates that viscous boundary layer effects 
are very Important In transonic flow. For example, an aft-cambered airfoil 
invlscidly designed to have a lift coefficient of 0.6 may actually develop 
25 to 50 percent less lift. This loss In lift Is due not only to the 
existence of a boundary layer displacement surface but also to such factors 
as wake curvature and vertical pressure gradients In the trailing edge 
region. To prevent such discrepancies, the effect of the viscous boundary 
layer should be Included In both the analysis and design portion of any 
numerical method. 

In the present program, the approach is to assume that the inviscid 
streamlines follow a displacement surface having ordinates and slopes 
different from the actual airfoil. The effect of the fact that the 
streamlines do not follow a displacement surface in the vicinity of the 
trailing edge and that they are Influenced by wake curvature Is assumed to 
be either secondary or capable of being handled empirically. In the design 
case, the approach is to treat the airfoil determined by the inverse method 
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as the displacement surface and to subtract from It the displacement 
thickness determined by a boundary layer computation. The result Is 
considered to be the actual airfoil ordinates. For the analysis case, the 
approach is to calculate a boundary layer displacement surface (l.e., 
airfoil ordinate plus 5*) using underrelaxation. The invlscid flow field 
Is then solved, and the displacement surface Is updated every ten Iterative 

cycles. 

Obviously, the boundary layer scheme must be reliable, reasonably 
accurate, and computationally very efficient. After extensive 
investigation, the Nash-Macdonald method (Ref. 2.4-10) together with 
certain smoothing operations, was selected for Incorporation Into the 
present program. In addition, the displacement thickness at the trailing 
edge grid point was always determined by linear extrapolation from the 
previous two upstream grid point values. As a result, the basic approach 
used in the present program Is similar to that of Reference 2.4-11. 

To update the displacement surface, the momentum integral equation 

+ (H + 2-M 2 ) | {jf = r (2.4-58) 

is solved for the momentum thickness d using the formulas of Nash and 
Macdonald for skin friction, r, and the shape factor H = 5*/Q. This 
computation Is performed on the same grid spacing as the corresponding 
invlscid solution. The resultant displacement thickness is then smoothed 
everywhere and extrapolated to obtain the thickness at the trailing edge 
point. The smoothing is performed twice on grids having IMAX less than 55 
and four times on grids with IMAX greater than 55. 

This smoothing and extrapolation process appears to have two 
consequences. First, it reduces the rapid variations in the solution that 
sometimes occur in regions with high pressure gradients. Second, based on 
comparisons with experiments, the Nash-Macdonald method with smoothing and 
extrapolation seems to yield a trailing edge behavior that Is correct with 
respect to the effect of the boundary layer on pressure distribution and 
lift. Admittedly, this behavior is fortuitous and some sensitivity to grid 
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spacing has been detected. However, It should serve as a reasonable 
engineering model until a more complete, rational, tralllng-edge theory Is 
available. At that time such a theory could be easily Incorporated Into 
the present program. 

If a case with extensive upper surface separation Is encountered, the 
user may need to Incorporate the optional trailing edge correction feature 
of the program. In this correction the boundary layer Is solved using a 
modified pressure distribution that Is linear from a point XLSEP, 
corresponding to separation, to the trailing edge. The base pressure, 
which determines the pressure gradient in this region, is determined 
semi empirically. For aft-cambered airfoils, it Is automatically selected 
to be the same as the maximum value of the pressure coefficient encountered 
on the lower surface of the airfoil. For conventional airfoils, it should 
be selected by the user based upon experience. (A typical value is 0.6.) 
For aft-cambered airfoils the resultant modified boundary layer computation 
Is normally applied only to the upper surface and is only used to determine 
the ordinate and slope of the displacement surface at XLSEP. The slope is 
then assumed to be constant from XLSEP to the trailing edge and the 
resultant displacement surface shape determined. Based upon comparisons 
with experiment, this approach yields reasonably good results and 
eliminates oscillations in the pressure distribution which can occur due to 
very small changes In the displacement surface slopes. Thus the method is 
a combination of the approaches used in References 2.4-11 and 2.4-12. 

For conventional airfoils, the modified boundary layer computation is 
used to determine when the slope of the displacement surface becomes zero. 
From that point to the trailing edge the slope Is then held constant. This 
approach Is based on the concept that the streamlines from both the upper 
and lower surfaces should enter the wake almost parallel. Thus, for 
conventional airfoils, if the trailing edge correction is used, it should 
be applied to both surfaces. Since in most cases this correction is not 
needed on conventional airfoils, its extensive use is not recommended until 
it has been verified by experiment. 

In both the normal and corrected uses, separation is assumed to occur 
when (-0/ q dq/ds) is greater than 0.004. 
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Now one of the difficulties associated with using a cartesian grid Is 
that such a grid does not place a large number of computational points near 
the leading and trailing edges. Thus, the wave drag coefficient, which Is 
determined by Integration of the pressure distribution, has an inherent 
error associated with grid size, grid spacing, and the magnitude of the 
lift coefficient. Extensive comparisons with experimental data have 
indicated, however, that accurate estimates of the wave drag can be 
obtained by applying a suitable correction factor, CDCORR. This correction 
factor, which is different for each airfoil and computational grid, can be 
determined as a function lift from a series of calculations at different 
angles of attack at subcritical speeds, where the wave drag should be zero. 

For each subcritical calculation, using a CDCORR of zero, determine 
the axial and normal coefficients using 

CN = CL cos a + CDWAVE sin a 
CA = -CL sin a + CDWAVE cos a 

where CL is the lift coefficient determined from integration of the C p 
distribution. Then the true CDCORR corresponding to CL can be computed 
from 


CDCORR = CA + CN sin a / cos a 


This value can then be used in supercritical runs having the same CL. 

In some cases, it may be more convenient to compute the supercritical 
flows using a CDCORR of zero and to apply the correction later. In those 
cases, the following procedure can be used to determine the drag. First, 
compute the axial and normal coefficients using 


CN = CL cos a + CDWAVE sin a 
CA = -CL sin a + CDWAVE cos a 


(2.4-59) 
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Then correct the axial coefficient for the appropriate lift and grid by 


CA = CA - CDCORR 


and recompute CDWAVE by 


CDWAVE = CN sin a + CA cos a 
The total drag coefficient Is then given by 

CD = CDWAVE + CDF (2.4-60) 

In all cases the drag due to skin friction and to changes resulting 
from the displacement surface shape Is computed using the Squire-Young 
formula. While this formula Is not exactly theoretically correct, It has 
been found to yield very accurate predictions. 

2. 1.4.6 Massive Separation Model 

In the design and analysis of high performance airfoils, 
aerodynami cists would like not only to compute cruise behavior, but also to 
predict airfoil pressure distributions at high lift, high angle-of-attack 
conditions. Since such situations are characterized by large regions of 
separated flow and are dominated by strong viscous interaction effects, 
invlscld methods are not applicable. Furthermore, subsonic-transonic 
analysis and design computer codes (Refs. 2.4-13 and 2.4-14) typically only 
Include the effects of weak viscous interaction and fall to give acceptable 
answers whenever the length of the separated zone exceeds a few percent of 
the airfoil chord. 

However Barnwell (Ref. 2.4-15) recently demonstrated that the direct- 
inverse technique could be successfully applied to the low-speed high-lift 
case. By specifying the separation point, he was able to obtain excellent 
agreement with experimental data by solving the linear equation with direct 
nonlinear boundary conditions (airfoil ordinates specified) upstream of 
separation and inverse boundary conditions (pressure specified) downstream 
of separation. Thus, the question arose — could similar results be 
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obtained using the full potential equation coupled with viscous Interaction 
and letting the separation point and pressure level be determined as part 
of the solution? 

This section describes the flow model that can be used to determine 
the flow field about a low-speed single-element airfoil at high angle-of- 
attack, high lift conditions with massive boundary layer separation (Ref. 
2.4-16). 

As indicated previously, the present approach is based upon the 
direct-inverse method as developed in the TRANDES program and its ability 
to use either the displacement surface (airfoil ordinate plus displacement 
thickness) or pressure as the airfoil boundary condition. For the low 
speed high angle-of-attack case, the airfoil lower surface only experiences 
weak viscous interaction. The lower surface boundary layer, however, 
frequently has a long laminar run before transitioning to fully turbulent 
flow. Thus, the model needs to Include an Initial laminar boundary layer 
in its viscous Interaction section. On the upper surface the boundary 
layer Is also Initially laminar, but It quickly becomes turbulent In 
character followed by boundary layer separation and a separated zone which 
can extend over as much as three-fourths of the airfoil surface. 
Fortunately, however, the separated region at low freestream velocities is 
characterized by an approximately constant pressure level. Consequently, 
the low speed massive separation problem has been modeled as shown in 
Figure 2.4-6. 

To obtain the Inviscid portion of the flow field, the exact 
perturbation potential equation is solved Iteratively using a rotated 
finite difference scheme and column relaxation. To include viscous 
effects, the basic approach is to calculate a boundary layer displacement 
thickness for weak interaction regions and to use it to correct the 
location of the displacement surface (i.e., airfoil ordinate plus 
displacement thickness, 5*). For the strongly interacting separated zone, 
the pressure is specified and the location of the displacement surface is 
computed by integrating the surface-tangency conditions, with the initial 
conditions specified by the displacement surface slope and ordinate at the 
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Figure 2.4-6. Problem Formulation 
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Interface between the two regions. At present, the location and slopes of 
the displacement surface are updated every ten relaxation cycles. 

On the lower surface of the airfoil, the flow field Is determined 
using direct boundary conditions (airfoil specified) Including the effects 
of weak viscous Interaction. On the upper surface, the flow field Is also 
computed directly with viscous Interaction up to the separation point, 
which Is determined as part of the solution. Downstream of separation, 
Inverse boundary conditions are used, and the pressure is assumed to be 
constant In the separated zone. Studies with this model have shown that 
the separated-zone pressure, which has to be computed as part of the 
solution, must be determined by conditions at both the separation point and 
at the trailing edge and not just on conditions in the vicinity of 
separation. 

In the present formulation, the pressure coefficient for the constant 
pressure separated zone Is computed by the equation 

c , - ; <*ITE - W (2.4-61) 

p,sep Xj TE - x sep 

as illustrated on Figure 2.4-7. Here and l se p are the perturbation 
potentials at the trailing edge and the turbulent boundary layer separation 
point, respectively. Note that Equation (2.4-61) is a small -perturbation 
approximation for Cp t sep* w ^ile this form probably Introduces some 
error Into the overall problem, its usage has been found to be simple, 
accurate, and adequate. 

In principle, the separated region and wake probably should be 
accurately modeled with respect to physical phenomena and details. This 
would typically introduce a large number of computational points to model 
the wake region. In the present model, however, the wake region contains 
very few computational points due to the coordinate stretching. Thus, it 
is treated very simply in that it is assumed to be inviscid with a constant 
pressure-trailing edge formed by the upper and lower displacement surfaces. 
As will be discussed later, this simplistic approach yields results which 
agree well with experimental data. In fact, numerical experiments with the 
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present model Indicate that the results for the pressure distribution and 
aerodynamic coefficients are primarily dependent upon obtaining accurate 
predictions for the location of the separation point and the magnitude of 
the separated pressure. Apparently, the details of the wake region are of 
secondary Importance. Finally, as shown in Figure 2.4-7, the airfoil 
circulation, T, Is modeled as the difference In the perturbation potentials 
at the airfoil trailing edge, i.e., T = “ 0L» ancl not as (0ITE " 00 • 

In the present code the turbulent boundary layer is computed using the 
Nash-Macdonald method In the same manner as In the original TRANDES program 
(Ref. 2.4-15). For the laminar portion, the boundary layer Is computed 
using a compressible Thwaltes method which Is a slightly modified version 
of a NASA Langley code originally developed by Grumman Aerospace 
Corporation. These integral methods are efficient and reliable and yield 
excellent predictions for displacement thickness values. Internally, the 
transition point Is determined from a Granville type correlation based upon 
the difference between the local momentum-thickness Reynolds number and the 
value at the laminar instability point combined with the pressure gradient 
history. Sometimes, particularly on the upper surface at high angles of 
attack, laminar separation Is predicted upstream of the transition point. 

In these cases, the local momentum-thickness Reynolds number Is compared to 
an empirical correlation In order to determine If the laminar bubble Is 
long or short. If the estimate Indicates that the bubble Is long, the 
calculation proceeds, but a warning is printed which indicates that the 
results are probably In error. If the bubble Is short, Its length is 
assumed to be one horizontal Ax grid width (about 3 percent of chord) and 
the turbulent-flow computation Is Initiated at the next downstream grid 
point. As will be demonstrated, this very simple model and approach 
usually yield adequate results. 

The calculation procedure used in TRANSEP Is the same Iterative 
successive-column-relaxation scheme used in the basic TRANDES program 
except that the separation point and separated pressure level are permitted 
to vary. A convergence history for a typical case Is shown In Figure 
2.4-8. Initially, some oscillation occurs on each grid, but, as can be 
seen, the values quickly converge. Normally 400 iterative cycles are 
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performed on both the medium and fine grids. Also, the location of the 
separation point Is held fixed on the fine grid (typically 97 x 49 with 130 
points on the airfoil) at the x/c location computed on the medium grid (49 
x 25 with 66 points on the airfoil). 

Extensive Investigations with the present model (Ref. 2.4-16) have 
shown that the theoretical results are primarily dependent upon the 
accurate prediction of the upper surface separation-point location. In the 
Nash-Macdonald integral method, separation Is assumed to occur when a 
parameter, SEP, defined as 


sep * - § af < 2 - 4 - 62) 

exceeds a specific value, SP. Here 6 Is the local momentum thickness, and 
q is the local boundary layer edge velocity. Obviously, agreement between 
the theoretical and experimental values requires an appropriate selection 
of the value for SP In order to obtain the correct separation point. 

Theoretically, in the Nash-Macdonald method, separation occurs 
whenever the displacement-momentum thickness ratio, 6*/6, exceeds three. 

At low speeds and low angles of attack, this value usually corresponds to 
an SP of about 0.0055. In Reference 2.4-15, however, it was found that at 
transonic speeds, an SP value of 0.0040 was more appropriate. Interest- 
ingly, the present study indicates that accurate results can only be 
obtained at high angles of attack by making SP a function of angle of 
attack, a, Reynolds number, RN, and the low angle of attack lift curve 
slope, C L . The present best estimate for this correlation Is: 
a o 

For a £15. 3° 

Use: SP = -7.14352 x 10“ 5 a + (0.0142857 C L + 0.004714337) 

CL 

If: SP > 0.0055, set SP = 0.0055 

For a > 15.3° 
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Use: SP = 3.6213784 x 10" 3 + 0.0142875 C L + (-8.4074 x 10" 11 RN 

+ 2.1707 x 10-4) ( a _ 15.3) 0 

where the angle of attack, a, Is always In degrees. 

This formula should be viewed strictly as an empirical attempt to 
force the correction separation point behavior Into the Nash-Macdonald 
approach as It Is formulated in a finite difference grid. Thus, the user 
should anticipate further empirical modification of it if his experience so 
dictates. This alteration should not be viewed as a criticism of the Nash- 
Macdonald method. Nevertheless, it should lead to reasonable results for 
the flow about low-speed airfoils up to C|_ max , and sometimes even beyond 
CLmax* 

2. 4. 1.7 Input Variable Description 

The input cards are summarized below: 

Read 


Order 

Variables 

Format 

1 

NTITLE 

20A4 

2 

NAMEL I ST/ F I N P/M , W , XI , X2 , ALP , EPS , EPSS , X4 , S4 , CONV , 

A1,A2,A3,RN,XIBDLY,CIR,CDC0RR,RDEL,RDELFN,SP, 

XSEP,XLSEP,XPC 

Namelist 

3 

NAMELIST/IINP/IMAX, JMAX, IKASE, INV, MITER, NHALF, ITACT, 
ISKP2, ISKP3 , ISKP4, ITERP, IREAD, LP, ITEUPC, ITELWC 

Namelist 

4 

P(I,J) 1=1, IMAX; J=1 , JMAX (Only if IREAD=1) 

5E15.7 

5 

PB(I) 1=1, IMAX (Only if IREAD=1) 

5E15.7 

6* 

XI, X2 

2F10.5 

7 

NI 

15 

8 

XI (I) , YI (I) , 1=1, NI 

8F10.4 

9 

DERIX,DERIY,DERFX,DERFY 

8F10.4 

10 

NIB 

15 


*Read only in the design mode when INV=1. 
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8F10.4 


11 XIB(I) , YIB(I) , 1=1, NIB 

12 DERIXB , DERIYB , DERFXB , DERFYB 

13* XI, X2 

14* CPU(I), 1=11, ITE 

15* CPL(I) , 1=11 , ITE 

16* X1.X2 

17* CPU(I), 1=11, ITE 

18* CPL(I) , 1=11 , ITE 

19* XI, X2 

20* CPU(I), 1=11, ITE 

21* CPL(I) , 1=11, ITE 


8F10.4 

2F10.5 

8F10.3 

8F10.3 

2F10.5 

8F10.3 

8F10.3 

2F10.5 

8F10.3 

8F10.3 


NOTE: In the design mode Steps 13-15 are for the coarse grid, 16-18 for 

the medium and 19-21 for the fine grid (if used). 


The definitions of these input variables are as follows: 

NtitlE “ Description of case. Up to 80 alphanumeric characters. Appears 
on printed output, at the beginning of the results for each grid. 

M - Freestream Mach number (real variable). Default 0.5. 

W - Relaxation factor for subsonic points. Should be in the range 
0<W<2 . 0 . Default 1.7. 

XI - X location where direct calculation stops. In analysis mode it 
should be set to 0.5 (i.e., trailing edge). In design mode it is 
usually set to slightly less than the third point from the leading 
edge or larger. Default 0.5. 

X2 - End of the inverse region. For analysis case set to a large 

number. In inverse design case set to 0.5 (i.e., trailing edge). 
Default 10000.0. 

ALP - Angle of attack in degrees. Default 0.0. 


*Read only in the design mode when INV=1. 
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EPS - Subsonic damping factor to match difference equations at sonic 
line If needed. EPS has no effect on accuracy of solution, only 
on stability and convergence rate. Normally it Is not needed. 
Default 0.0. 

EPSS - Supersonic damping factor for Iterative stability. Note that EPSS 
has no effect on the accuracy of the converged solution, only on 
the stability and convergence rate. EPSS should typically be 
about M^ax-l, where M max is the maximum local Mach number. 

Default 0.4. 

X4 - The positive X location where the coordinate stretching changes. 

It should be near the airfoil trailing edge. Default 0.49. 

S4 - The positive $ value in the computational plane where the 
stretching changes. Default 2.0. 

CONV - Convergence criteria control value. Iterations stop when the 

maximum change in the perturbation potential (between relaxation 
cycles) Is less than CONV. Default l.E-05. 

A1 - Stretching constant for the Y direction. It can be used to 

control AY and Lrj near the horizontal axis. It is usually best to 
have A$- = A 17 near the leading edge of the airfoil. Default 0.246. 

A2 - First stretching constant for the X-dlrection. It Is equivalent 
to f (if) at £ = £ 4 * The va l ue °f a 2 determines the horizontal 
step size near the leading and trailing edges, I.e., 



Default 0.15. 

A3 - Second stretching constant for the x-dlrection. It determines the 
physical location of the vertical grid line adjacent to grid side 
edge. Default 3.87. 
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RN - Freestream Reynolds number based on chord length. Used only when 
viscous interaction Included. Default 20.E+06. 

CIR - Circulation about airfoil. If an Initial solution Is Input, It 
must be the corresponding value of circulation. (CIR = C[_/2.0). 
Default 0.0. 

CDCORR - Correction to the computed wave drag coefficient for the finest 

grid used. Because of the lack of a large number of points In the 
leading and trailing edge regions, the wave drag coefficient has 
an error associated with grid size, spacing, and lift coefficient. 
The magnitude of CDCORR as a function of lift can be determined 
from a series of calculations at different angles of attack at 
subcritical speeds, where the wave drag should be zero. Note that 
the correction should be determined for each airfoil and grid 
combination. Default 0.0. 

RDEL - Relaxation parameter for the boundary layer displacement 

thickness. It is used only when viscous interaction is included 
and IMAX * 55. Default 0.25. 

RDELFN - Fine grid relaxation parameter for the boundary layer displacement 
thickness. It is used only when viscous interaction is included 
and IMAX > 55. Default 0.125. 

SP - Maximum value allowed for the Nash-Macdonald separation parameter 
when x > XSEP. Used only in the viscous interaction case. 

Default 0.004. 

XSEP - X location after which the Nash-Macdonald separation parameter can 
assume its calculated value. Used only in the viscous interaction 
case. Default 0.44. 

XPC - Location after which the lower surface displacement thickness is 
required to continue decreasing once it has started to decrease. 
Upstream of XPC the displacement thickness is required to be 
monotoni cal ly increasing. For most aft-cambered airfoils it 
should be 0.1 and in conventional airfoils it should be 0.5. 
Default 0.1. 
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IMAX - Number of vertical grid lines In the horizontal direction. 1=1 
Is upstream Infinity and I = IMAX Is downstream Infinity. For 
each grid refinement IMAX Is Increased such that IMAX new = 
2(IMX 0 ](j) - 1. The limit on IMAX Is 99. Default for use on first 
grid Is 13. 

JMAX - Number of horizontal grid lines In the vertical direction. J = 1 
corresponds to infinity below the airfoil and J = JMAX is infinity 
above the airfoil. The same formula and limit that apply to IMAX 
also apply to JMAX. Default 7. 

IKASE - An Integer number describing the case. It is limited to a maximum 
of six digits. Default 100. 

INV - Parameter determining program mode. It should be zero for 
analysis cases and one for inverse design cases. Default 0. 

MITER - Maximum number of Iterations (complete relaxation cycles) allowed 
on first grid. MITER is halved for each grid refinement. 

However, on the fourth grid, MITER Is reset to 400. Default 2. 

NHALF - Number of grid refinements to be done. Default 2. 

ITACT - Viscous Interaction control parameter. It should be set to zero 
for analysis cases without Interaction and for design cases. It 
should be one for analysis cases with Interaction. Default 0. 

ISKP2 - Airfoil update control parameter for grid two. It should be 0 if 

on grid two an update is desired every 10 Iterations. It should 

be 1 If an update is not desired until the grid two solution is 
completed. Only used in the Inverse design mode. Default 0. 

ISKP3 - Same as ISKP2 but for grid 3 (medium grid). 

ISKP4 - Same as ISKP2 but for grid 4 (fine grid). 

ITERP - Interpolation parameter. If In the design mode the input Cp 

distribution for the grid 4 is to be read In, ITERP should be 0. 

If it is desired to linearly Interpolate the C p distribution of 
grid 3, It should be 1. Default 0. 
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IREAD - Starting solution control parameter. If IREAD Is 0, the Initial 
perturbation solution Is assumed to everywhere be zero. If It Is 
1, an Initial solution Is read In from data cards. Default 0. 

LP - Relaxation cycle Interval at which boundary layer, surface 

ordinates, etc., details are printed. Useful for diagnostics. 
Default 1000. (No printout.) 

ITEUPC - Upper surface trailing edge correction control parameter. If 

trailing edge correction desired, ITEUPC should be 1. If not it 
should be zero. Only used In the viscous interaction case. 
Normally the correction Is not needed. Default 0. 

ITELWC - Lower surface trailing edge correction control parameter. If 
correction desired, ITELWC should be 1. If not it should be 0. 
Only used in the viscous interaction case, and normally the 
correction Is not needed. Default 0. 

P(I,J) - Nondimensional perturbation potential, j , at point I,J. 

PB(I) - Nondimensional perturbation potential at point I on the y=0 grid 
line. 

XI, X2 - Same definition as above. However, in the inverse design case 

they must be read in prior to the solution of each grid. On the 
first grid (Step 6 in above listing) should use Xl=0.5, 

X2=10000.0. On remaining grids (Steps 13, 16, and 19), XI should 
be the location where the direct calculation stops and X2 should 
b3 0.5. 

NI - The number of coordinate pairs used to describe the upper surface 
of the airfoil. Presently limited to 99. 

XI (I) - Input coordinates In the horizontal direction for the airfoil 

upper surface. The leading edge corresponds to XI=0.0 and the 
trailing edge is XI=1.0. 

Yi (i) - Input coordinates In the vertical direction for the airfoil upper 

surface. 
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DERIX - DX/DS of the airfoil upper surface at the leading edge (XI=0.0). 
It usually Is 0.0. 

DERIY - DY/DS of the airfoil upper surface at the leading edge (XI=0.0). 
It usually Is 1.0. 

DERFX - D 3 x/DS 3 of the airfoil upper surface at the trailing edge 
(XI=1.0). It Is usually sufficiently accurate to use 0.0. 

DERFY - D 3 Y/DS 3 of the airfoil upper surface at the trailing edge 
(XI=1.0). It is usually sufficiently accurate to use 0.0. 

NIB - The number of coordinate pairs used to describe the lower surface 
of the airfoil. Presently limited to 99. 

XIB(I) - Input coordinates In the horizontal direction for the airfoil 

lower surface. The leading edge corresponds to XIB=0.0 and the 
trailing edge is XIB=1.0. 

YIB(I) - Input coordinates in the vertical direction for the airfoil lower 
surface. Since positive Is up, the values of YIB are usually 
negative. 

DERIXB - DS/DS of the airfoil lower surface at the leading edge. It is 
usually 0.0. 

DERIYB - DY/DS of the airfoil lower surface at the leading edge. It Is 
usually -1.0. 

DERFXB - D 3 X/DS 3 of the airfoil lower surface at the trailing edge. It Is 
usually sufficiently accurate to use 0.0. 

DERFYB - D 3 Y/DS 3 of the airfoil lower surface at the trailing edge. It Is 
usually sufficiently accurate to use 0.0. 

CPU(I) - Upper surface Inverse region C p values for design case. II, which 
Is computed internally, is the first grid point after XI. The 
distribution must be read in for each grid solved Inversely (Steps 
14, 17, and 20) . 

CPL(I) - Lower surface inverse C p values for design case. They must be 
read in for each grid solved inversely (Steps 15, 18, and 21). 
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XIBDLY - The x-locatlon at which upper surface transition is assumed to 
occur. The turbulent boundary layer calculation starts at the 
next grid point. The relationship to percent chord Is: 

XIBDLY = (%chord - 50.0)/100.0 

Used only If I LAM = 0. Ignored If I LAM = 1. 

Default -0.44. 

XLSEP - When IMASS = 0, location at which the trailing edge correction 
procedure begins. Between XLSEP and the trailing edge the 
pressure distribution and the displacement surface is modified. 
Used in this fashion only if ITEUPC and/or ITELWC equal 1. When 
IMASS = 1, set to a number forward of expected separation point. 
Default 0.50. 

XLBDLY - The x-locatlon at which lower surface transmission is assumed to 

occur. Same relationship to chord is XIBDLY. Used only if I LAM = 
0. Ignored If I LAM = 1. Default - 0.44. 

RLAX - Relaxation parameter for separated pressure level. Sometimes 
needed to enhance convergence. It is used only when ITACT = 1. 
IMASS = 1. Default 1.0. 

RADUS - Leading edge nose radius, rLE/c* Use< * on ^Y ^ ILAM = Defalt 
0.035. 

CLALP - Low angle of attack lift curve slope. Used only if IMASS = 1. 
Default 0.10966. 

ILAM - Boundary layer parameter. If zero, boundary layer is all 

turbulent. If one, boundary layer Is laminar-turbulent with 
natural transition. Default 0. 

IPRTl - Print parameter. If one, perturbation potential values printed at 
the completion of each grid. Default 0. 

IPRT2 - Print parameter. If one, x and y velocities at each grid point 

printed at the completion of each grid. Values printed as part of 
Mach chart. Default 0. 
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IMASS - Massive separation parameter. It should be one for massive 

separation cases and zero for all others. To utilize, ITACT must 
be 1. Default 0. 

2.4. 1.8 Output Description 

The program output for each grid In the massive separation mode Is: 

(1) Heading 

(2) Coordinate system. It Is printed as I , X (I) followed by J,Y(J). 

(3) Mach number, angle of attack and location where direct 
calculation stops 

(4) Case number 

(5) Case type callouts, I.e., 

• Invlscld analysis case 

• With viscous interaction 

• Massive separation 

(6) Input data In namelists FINP and IINP 

(7) Airfoil ordinates in direct region 

X - horizontal ordinate, where -0.5 Is leading edge and 0.5 Is 
the trailing edge 
YU - Upper surface ordinate 
YL - Lower surface ordinate 
Upper Slope - Upper surface slope 
Lower Slope - Lower surface slope 

(8) Iteration history at ten-cycle intervals 
CIR - Circulation 

DPM - Maximum ^ correction (absolute value) in the last 
relaxation cycle, with the corresponding ( I , J) grid 
location 

NSSP - Number of supersonic points 
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DELTAY or DELSTAR - S* at the trailing edge for massive 

separation, should go to a constant if 
solution Is converging. Only changes after 
first 50 cycles on each grid. 

Separation point and separated Cp are printed. 

(9) Laminar boundary layer values (every LP cycles) 

X - Horizontal ordinate 

CF - Skin Friction Coefficient (the 0.1 x 10 11 value Is an 
arbitrary initial value and should be ignored) 

D-STAR - 5*/c, nondimenslonal boundary layer displacement 
thickness 

D-THETA - 9/ c, nondimensional momentum thickness 

H - 6*19, shape factor 

RE-THETA - Reynolds number based on & 

RE-STAR - Reynolds number based on 6* 

TM - 6 2 Pressure gradient parameter 

(10) Laminar flow messages 

(a) SEPARATION OCCURRED AT X = _; gives x location where 
laminar separation occurred 

(b) SHORT BUBBLE FORMED? TRANSITION TO TURBULENT FLOW ASSUMED, 

X = 

(c) LONG BUBBLE? LAMINAR STALL MAY OCCUR, X = _ BOUNDARY LAYER 
CALCULATION WILL BE CONTINUED AS TURBULENT BUT ACCURACY OF 
RESULTS IS QUESTIONABLE 

(d) BOUNDARY LAYER CONCULATION COMPLETED? NEITHER SEPARATION 
NOR TRANSITION WAS DETECTED 

(11) Turbulent boundary layer values 

X - Horizontal ordinates 

M - Local Mach Number 

DELS - 5*, displacement thickness 

THETA - 9, momentum thickness 

SEP - parameter used to determine if separation occurs 
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H - shape factor 
S* dD 

PI - — pressure gradient parameter 

TAU - ^//ju 2 , nondlmenslonal wall shear force 

CF, D-STAR, D-THETA, H r RE-THETA, RE-STAR, TM (see 9) 

(12) Lower surface flow messages 

(a) BOUNDARY LAYER CALCULATION COMPLETED? 

(b) NEITHER SEPARATION NOR TRANSITION WAS DETECTED 

(13) Upper surface flow message gives separation point and Cp for 
separated region 

(14) 1st group - x - horizontal ordinates 

YU, YL, location of the surface ordinates in the 
computational plane 

2nd group - x - horizontal ordinates 

YU, YL, slopes of upper and lower surfaces in physical plane 

repeat (8) through (14) until convergence 

(15) Final boundary layer results 

YUORIG - Original airfoil upper surface ordinates 
DU - Upper surface displacement thickness 
SLU - Slope of upper displacement surface 
YLORIG - Original airfoil lower surface ordinates 
DL - Lower surface displacement thickness 
SLL - Slope of lower displacement surface 

(16) Pressure distribution on airfoil 

(17) Displacement surface ordinates and slopes in physical plane 

(18) Mach chart, numbers printed are Mach number multiplied by 100. 
Velocities (U,V) may also be printed. 

(19) Wave drag coefficient 
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(20) Plot of results 

U - Upper surface Cp 

L - Lower surface Cp 

T - Upper displacement surface 

B - Lower displacement surface 

CLCIR - Lift coefficient from circulation 

CL - Lift coefficient from Integration of C p 

Cg - CDWAVE + CDF 

CMLE - Moment coefficient about leading edge 
CDF - Drag coefficient by modified Squire-Young 
CMC4 - Moment coefficient about quarter chord 
NOTE: For low speed massive separation, Ignore CDWAVE and CD. 

Use CDF only. 

2.4.2 Airfoil Data Banks 

The current version of GAPAS contains two airfoil data banks. The 
first Is for the Clark-Y series and the second, the NACA 16 series. The 
details of the data banks are described below. 

2.4.2. 1 Clark-Y Series 

The Clark-Y airfoil data bank calculates the lift coefficient, drag 
coefficient, llft-to-drag ratio, and the moment coefficient about the 
leading edge or about the quarter chord. Some limitations exist In the 
program, and when exceeded, flags are built Into the program to indicate 
what value exceeded the limitation and where In the program it occurred, 
under "Limitations" In the output of the program. 

Input 

The input list Includes the following parameters: Mach number (s) 

(HM); angle (s)-of-attack (ALPHA) referenced from the longest chord in 
degrees; altitude (ALTUDE) In feet; chord length (CHORD) in feet; 
thlckness-to-chord ratio (T) - equal to the known value of the thlckness- 
to-chord ratio or equal to 0 if the value Is unknown; number of Mach 
numbers (NUMACH); number of angles-of-attack (NUMALP); lift coefficient 
factor (NCL) - If not equal to 0, the lift coefficient Is calculated; drag 
coefficient factor (NCD) - If not equal to 0, the drag coefficient is 
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calculated; airfoil section coordinates factor (L) - If not equal to 0, the 
Clark-Y airfoil section coordinates and Its moments of Inertia are given; 
design lift coefficient or equal to 0 If the value Is unknown; moment 
coefficient parameter (M) - If equal to 0 a moment coefficient Is not 
calculated, If equal to 1 the moment coefficient about the leading edge Is 
calculated, and if equal to 2 the moment coefficient about the quarter 
chord Is calculated. 

Main Program Description 

When the number of data are changed for parameters HM (Mach number) 
and ALPHA (angle of attack), the dimension statements DATA NUMACH and DATA 
NUMALP must also be changed accordingly. 

Subroutines 

(1) ATMCON calculates temperature, pressure, speed of sound, density, 
and viscosity for given altitude. 

(2) CYCOOR gives the dimensions and section properties for a Clark-Y 
airfoil section for any given thickness and reference chord. It 
also calculates the moment of inertia for the major and minor 
axes. The Input units will correspond with the output units, 
however the coordinates are nondlmensional with respect to the 
reference chord. The upper and lower x-coordl nates are 
Identical . 

(3) CLTMAX contains the equation for design lift coefficient as a 
function of maximum thickness-chord ratio, and the equation for 
maximum thickness-chord ratio as a function of design lift 
coefficient. These equations are generated from plotting the 
calculated CLD versus (T/C)MAX using the data from NACA TR 628 
(Ref. 2.4-17). The design lift coefficient and thickness-to- 
chord ratio have a parabolic relationship and are fitted to the 
curve with the equation NCLD=(-0.16879+SQRT(0. 02849 
+0.496405*NTMAX))/0. 248205. If the thlckness-to-chord ratio 
(NTMAX) needs to be calculated, the following two equations are 
used: 
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(a) NTMAX=0.1241*NCLD**2+0.16879*NCLD If NCLD Is positive, 
or 

(b) NTMAX=0 . 1241*NCLD**2-0 . 16879*NCLD if NCLD Is negative. 

The section slope of the low speed lift curve for each thickness 
Is also calculated and stored in FUNCTION AOIOF. With the value 
for CLD and AO, the angle of attack at zero lift is calculated. 

(4) CLCD contains numerous functions which Interpolate the contained 
data tables through Lagrangian method, and determines the lift 
and drag coefficients according to corresponding Mach number, 
maximum thickness-chord ratio and angle-of-attack. The data base 
for this subroutine is from Haines and Monaghan (Ref. 2.4-18) and 
MacDougal 1 (Ref. 2.4-19). The equations and data tables 
contained in this document form the basis for all further 
discussion concerning this subroutine. 

The lift coefficient Is calculated by multiplying the lift curve 
slope by the angle-of-attack relative to the zero lift line. If 
the thickness-to-chord is less than 16 percent, the critical Mach 
number is determined. If the Mach number is less than the 
critical Mach number, the lift coefficient calculated Includes 
the Prandtl-Glauert correction. If the Mach number is greater 
than the critical Mach number, the lift coefficient is calculated 
by the following equation: CL=CL0/SQRT(1-HML*HML)+CLSF(H) where 

CLO is the Incompressible lift coefficie4nt, HML Is the critical 
Mach number, and the function CLSF(H) calculates the difference 
of the lift coefficient at a Mach number above the critical from 
Its critical value. 

For the calculation of the drag coefficient, data tables are set 
for thickness ratios of 0.09, 0.10, 0.11, 0.12, 0.13, 0.14, 0.15, 
0.16, 0.17, 0.19, 0.21, 0.23, 0.25, 0.30, and 0.35 at angles-of- 
attack of 3, 4, 5, 6, 7, 8, 9, 10, and 11 degrees. A Lagrangian 
interpolation routine interpolates between the tables to obtain 
the desired drag coefficient. 
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(5) Function CMFF contains the moment coefficients about the leading 
edge and about the quarter chord. The variation of the moment 
coefficient with the lift coefficient Is determined for several 
thlckness-to-chord ratios through data obtained from the Smetana, 
et.al. airfoil analysis code. A linear relationship Is found and 
fitted to a simple line equation. The variation of the slope and 
the Intercept with the thlckness-to-chord are determined, and 
quadratic equations are fitted to the curves. The quadratic 
equations are substituted Into the line equation to obtain the 
final equation for the moment coefficient. The equation for the 
moment coefficient about the leading edge is, CMLE=T**2* 

( -0. 3065*CL+0. 875) -T* (0. 1514*CL+0. 705) -0.23993*CL+6. 25/ 100000. 

The equation for the moment coefficient about the quarter chord 
Is, CMQC= (-0 .44*CL+1 . 15) *T**2- 

(0.0993*CL+0.785)+0.0036*CL+0. 00638. The compressibility effects 
are Included by dividing the moment coefficient by the Prandtl- 
Glauert correction. 

2. 4. 2. 2 NACA 16 Series 

The NACA 16-Series airfoil data bank calculates the lift coefficient, 
drag coefficient, lift-to-drag ratio, and the moment coefficient about the 
leading edge or about the quarter chord. Some limitations exist in the 
program, and when exceeded, flags are built Into the program to Indicate 
what value exceeded the limitation and where In the program It occurred, 
under "Limitations" In the output of the program. A Mach number of 0.0 is 
not allowable. Also, the program has difficulty handling negative angles- 
of-attack of large magnitude at high Mach numbers for thick airfoils. 

Input 

The Input list includes the following parameters: the drag 

coefficient compressibility check factor (ICD) - if equal to 0, the 
incompressible drag coefficient is given, and if equal to 1, the 
compressible drag coefficient is given; the lift coefficient 
compressibility factor (ICL) - if equal to 0, the incompressible lift 
coefficient is given, and if equal to 1, the compressible lift coefficient 
Is given; a check parameter which controls the format of the output (IF0RM) 

- if equal to 0, all of the increments in the drag are given, and if equal 
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to 1, a tabular output of the lift coefficient (CL), the drag coefficient 
(CD), the 1 1 ft-to-drag ratio (CL/CD), and the moment coefficient about the 
leading edge (CM(LED)) or the moment coefficient about the quarter chord 
(CM1/4) ) Is given for each angle-of-attack (ALPHA), one table Is given for 
each Mach number; number of angles-of-attack specified (NUMALP); number of 
Mach number; number of angles-of-attack specified (NUMALP); number of Mach 
numbers (NUMACH); design lift coefficient (CLD) - equal to the known value 
of the design lift coefficient or equal to 0 If the value Is unknown; the 
airfoil section area (AREA) - equal to the known value of the section area 
or equal to 0 if the value Is unknown; thickness-to-chord ratio (TC) ; chord 
length (CHORD) In feet; altitude (ALTUDE) In feet; Mach number(s) (M); 
angle(s)-of-attack (ANGLE) referenced from the longest chord in degrees; 
angle of zero lift (ALPHAO); radial location (X); the moment coefficient 
parameter (MP) - If equal to 0, a moment coefficient Is not given, If equal 
to 1, the moment coefficient about the leading edge is given, and if equal 
to 2, the moment coefficient about the quarter chord Is given; and the 
airfoil coordinate parameter (L) - If not equal to 0, the NACA 16-Series 
airfoil section coordinates and Its moments of Inertia are given. 

Main Program 

When the number of data are changed for parameters M (Mach number) and 
ANGLE (angle of attack), the dimensions for M and ANGLE, DATA NUMACH, and 
DATA NUMALP must also be changed accordingly. 

For the calculation of the moment coefficient about the quarter chord, 
data tables are set up for design lift coefficients of 0.0, 0.1, 0.3, and 
0.5 at Mach numbers of 0.3, 0.45, 0.6, 0.7, and 0.75 with thickness ratios 
of 0.02, 0.06, 0.09, 0.12, 0.15, 0.21, and 0.30. A Lagrangian 
interpolation routine Interpolates between the tables to obtain the desired 
moment coefficient. The data tables are taken from Lindsey, Stevenson, and 
Daley (Ref. 2.4-20). The moment coefficient about the quarter chord is 
transformed to the leading edge with the following equation: 

CMLE=CMQC-0.25*CL. 
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function of thickness. Given a thickness and a Mach number, the program 
calculates the drag-divergence Mach number by linear Interpolation, and 
tests to see If the specified Mach number Is above or below the drag- 
divergence Mach number. It then calculates the basic drag coefficient 
accordingly. For subsonic section velocities, the subroutine performs a 
linear Interpolation If the local Mach number is below the drag-divergence 
Mach number, or uses a polynomial curve fit for local Mach numbers above 
the drag-divergence Mach number. For supersonic section velocities, the 
subroutine uses a polynomial curve fit on the supersonic segment of the 
curve to arrive at a value for the basic drag coefficient. Note that If 
the thickness Is less than 0.03 or If the basic drag coefficient Is 
negative, then the basic coefficient is set equal to 0.0. 

Data for the drag coefficient due to lift calculation is based on 
Cooper (Ref. 2.4-21). First, DELTA=(CLXCLI) . Then, the subroutine 
calculates the weighted Mach number, XMXT=XM/(0.9-XTC) . Then It calculates 
DELCD using the formula: DELCD=(XMXT**2-XMXT-0.1765)*(-0.4397*DELTA**2+ 

0.1173*DELTA-0.0938) . Next, TESTM Is calculated. TESTM is the value of 
XMXT on the line labeled LIM A in Figure 9A of Reference 2.4-23 which 
corresponds to the value of DELCD just calculated: TESTM=(DELCD-0.03)* 

(0.9-0.875) /(0. 03-0. 08)+0. 9. If the value of XMXT is greater than TESTM, 
the equation above does not hold, and the value of DELCD is arrived at by 
using a sixth degree polynomial curve fit to find the slope of the plot. 
Then, DELCD=SL0PE* (XMXT-1.011111)+0. 0911111. The subroutine then tests if 
the Mach number is supersonic. If so, DELCD=SQRT(XM**2-l)/4 and DELTA=CL. 
Once DELTA and CL have been calculated in the proper manner, the drag 
coefficient due to lift Is given by: CDLIFT=DELCD*DELTA**2. 

The coefficient of drag due to friction Is a function of Reynolds 
number and percent laminar flow, and is also based on the work of Cooper. 
This subroutine determines the percent laminar flow over the airfoil (PLAM) 
by a second degree polynomial curve fit: PLAM=(33+l/3)*XR**2+(8+l/3)* 

XR+17, after which, the Reynolds' number for the airfoil is calculated by 
XRN=DEN*XM*WA*CH0RD/VIS. When the Reynolds number and the percent laminar 
flow are determined, the drag coefficient due to friction is calculated 
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from: CDFRIC=2.65/SQRT(XRN)+(100-PLAM)/PLAM*(0.944/DLOG10(XRN)**2.65/SQRT 

(SQRT(XRN)) . 

The drag due to camber represents the Increase In the minimum basic 
drag coefficient of cambered NACA 16 -Series airfoils over that of the 
uncambered airfoils of the same series. The drag coefficient due to camber 
(CDCAMB) Is completed In the form of a plot of CDCAMB vs. XMXT as a 
function of the design lift coefficient. The subroutine performs a series 
of linear interpolations to find the proper drag coefficient due to camber 
at a specified XMXT for a specified design lift coefficient. 
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2.5 ACOUSTICS MODULE 


The primary acoustics analysis procedure and computer code selected 
for Inclusion In GAPAS Is that developed at NASA-Langley by Martin and 
Farassat. The computer code Is called SPN (Subsonic Propeller Noise); an 
advanced version to Include transonic and supersonic flow effects, called 
TPN (Transonic Propeller Noise) has also been developed by NASA-Langley and 
Incorporated Into the current version of GAPAS. 

2.5.1 Problem Definition 

This module computes the periodic acoustic pressure signature and 
spectrum of a propeller rotating at subsonic tip speed (SPN) or transonic/ 
supersonic tip speeds (TPN). The computation Is based on a solution of the 
Ffowcs Will iams-Hawkings (FW-H) equation without the quadrupole source term 
(Refs. 2.5-1 through 2.5-3). The blade surface pressure can also be peri- 
odic In time. The relative position of the observer with respect to the 
center of rotation of the noise source is always assumed to be fixed (e.g. t 
the observer is always assumed to be moving with the aircraft); only in 
such a frame is the acoustic pressure periodic. The main acoustic 
formulation uses the source distribution on the actual blade surface. 
Several approximations to the full solution are included as options. 

2.5.2 Subsonic Propeller Noise (SPN) 

A definition of symbols is provided below in order to allow the reader 
to more easily follow the analysis methodology. 

Symbols 

A Area of a blade section, m 2 (ft 2 ) 

c Ambient speed of sound, m/s (ft/s) 

d x Radial distance of observer from X3~axis, m (ft) 

dy Radial distance of source from X 3 ~axis, m (ft) 

f Function defining the blade surface 
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Frequency, Hz 


Symbol substituted for Integrands In Equation (2.5-41) 

Symbol substituted for Integrands In Equation (2.5-45) 

Azimuthal force on a single blade, N (lbf) 

Equation g = 0 describes relationship between source and observer 
time 

Harmonic number 

Local force per unit area of the blade acting on the fluid, Pa 
(lbf/ft2) 

Net force of the blade acting on the fluid, N (lbf) 

Net force per unit radial distance, N/m (lbf/m) 

Exponent; 2 m is the number of time points used by FFT routine 
Source Mach number 

Blade surface unit normal vector 
Number of blades 

Maximum harmonic number in calculations 
Number of times 

Surface pressure (p = p a - p 0 ) , Pa (lbf/ ft 2 ) 


< +S- 


p' Acoustic pressure, Pa (lbf/ft 2 ) 

p a Absolute surface pressure, Pa (lbf/ft 2 ) 

p 0 Ambient pressure, Pa (lbf/ft 2 ) 

P L Acoustic pressure produced by loading. Pa (lbf/ft 2 ) 

Pp Total acoustic pressure produced by propeller, Pa (lbf/ft 2 ) 

l 

P-p Acoustic pressure produced by thickness, Pa (lbf/ft 2 ) 

Ap Difference between lower and upper surface pressure, Pa (lbf/ft 2 ) 

P re f Reference pressure for definition of dB, 2 x 10“ 5 N/m 2 

r Vector from source point at emission time to observer, 

m (ft) (r = lx - y (r*) I) 

Unit vector In the direction of r 

Re Effective radial distance to be used in point source 

approximation, m (ft) 

SPL|< Acoustic spectrum, dB 

t Time at which noise signal is received by observer (s) 

A 

I Blade surface unit tangent vector 

T Net thrust from a single blade, N (lbf) 

v Source velocity, m/s (ft/s) 
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+x 


Forward velocity of the aircraft, m/s (ft/s) 

Observer position In the ground-fixed frame, m (ft) 

J Observer position In the aircraft-fixed frame, m (ft) 

y Source position in the ground-fixed frame, m (ft) 

^ Source position in the aircraft-fixed frame, m (ft) 


Greek 

5 Dirac delta function 

~rj Source position in the blade-fixed frame, m (ft) 

d Q Change in root pitch angle, rad 

0 Angle between the radiation vector and the surface normal vector, 

rad 

Q' Angle between the radiation vector and the surface tangent vector, 

rad 

£ ( 2 Elliptic surface coordinates 

p Ambient density, kg/m 3 (slug/ft 3 ) 

r 0 

a Local tangential stress, N/m^ (lbf/ft^) 

r Time at which noise signal is emitted at source position, s (s) 


r* Solution to the retarded time equation, g = 0, for a given 

observer time, s (s) 

T See Equation (2.5-27) 


Solution to retarded time equation as solved by Newton's method 
(l = D(r - t) ) , s (s) 
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Angle between the xj and rj\ axes, rad 


* 

♦ Blade volume, m 3 (ft 3 ) 

Superscripts 

Vector 

Mean 

A 

-*■ Unit vector 

• Time derivative 

* Complex conjugate; specific solution to retarded time equation 
Subscripts 

i Component along the i^h coordinate axis 

(note: r-j implies summation convention); also inner radius 

m Property of the mean blade surface 

n Component in the direction of the surface normal 

o Ambient condition; also outer radius 

r Component in the direction of the radiation vector 

2.5.2. 1 Acoustic Formulation 

The governing acoustic equation is the wave equation 

~2 rf - ?2 p' ■ ft tvn' 7f i*( f )] 

c ot 


- af- [v ,fl5 ( f >] < 2 - 5 -» 


01-168-86 


2-132 



This Is the FW-H equation without the quadrupole source term. The blade 
surface Is described by f(x,t) = 0. The acoustic pressure Is denoted by 
p\ v n Is the local normal velocity of the blade and li Is the local force 
per unit area of the blade acting on the fluid. The density and the speed 
of sound In the undisturbed medium are denoted as p 0 and c, respectively. 
The symbol 5(f) stands for the Dirac delta function. The two terms on the 
right of Equation (2.5-1) are known as the thickness and loading noise 
sources, respectively. Note that Equation (2.5-1) Is written in a Cartes- 
ian frame fixed to the undisturbed medium, which will be called the 
"ground-fixed frame." We will also use two other frames of reference which 
will be more suitable for describing the solution and computation of the 
noise. 

The FW-H equation Is valid In the entire three-dimensional unbounded 
space. The Green's function of the wave equation for the unbounded space 
is 5(g) /4rr where g = r - t + r/c and r = lx - yl. Here r and t are the 
source and the observer times and y and x are the source and observer posi- 
tions, respectively. Using this Green’s function, the formal solution of 
Equation (2.5-1) is 

4fp'(x,t) = ft / 7 Vn IVflfi(f){(9)d ^ dT 


" aT ^ r VVfi«(f)ff(g)dydr 


(2.5-2) 


Note that the Integrals above are four dimensional as written below: 


/ — dy dr = £ £ m ••• dydr 


(2.5-3) 


Before integrating Equation (2.5-2), we use the following identity 
established by differentiation: 


A 



(2.5-4) 
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A 

where rj = (x-| - y\)/r Is the unit vector In radiation direction. Since 
only the function £(g)/r Is dependent on x, the second term In Equation 
(2.5-2) may be rewritten as 


- 5T / 7 l,l»fl«(f)«( 8 )dydr ■ i §£ / A l r IVfl«(f)ff(g)dydr 

+ / h l r IVflS ( f )®(3)dydr (2.5-5) 
r 

A 

where l r = 1 i r-| . Using Equation (2.5-5), In Equation (2.5-2) gives 
4Tp'(x,t) = ^ ft / 7 ^o cv n +1 r ) IVfltf(f)tf(g) 3ydr 


+ / h ! r IVflff(f)ff(g) dydr . (2.5-6) 

r 

Now a Cartesian frame, denoted as the i)-frame, fixed to the blade is 
introduced. This frame will be referred to as the "blade-fixed frame." It 
Is assumed that the blade Is rigid so that Its surface description in the 
7 - frame Is time independent. To Integrate Equation (2.5-6), the following 
steps are employed: 

(1) Use the transformation of variable y + rj, 

(2) Use the transformation r + g to Integrate with respect to the 
variable, g, 

(3) Integrate the remaining delta functions. 

Step ( 1 ) : Since the Jacobian of the transformation Is 1 , It follows 

that the volume elements in the two spaces are equal. Also note that in 
the jy- frame the equation of the blade surface depends on jj only. This is 
obtained as follows 


ffy(5.7-),r] = ?(?) = 0 


(2.5-7) 
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That Is, the equation of the blade surface In the i)-frame Is obtained by 
substituting for yin terms of rj and r. Note that since the blade-fixed 
frame Is in motion, the transformation y + rj Is time dependent and y = 

~y(y, t). To reduce confusion, the tilde on ?(^) will be dropped In the 
following results. The function g Is defined as follows: 

g * r - t + lx- y(^,r)l/c (2.5-8) 

Step (2) : Now fix r/ and use the transformation r+g. The Jacobian of 

the transformation is 


J 


|3g/ar| ; = |l-M r | 


(2.5-9) 


where M r = vjri/c. Here v is the velocity of the point with position 
vector ? in the blade-fixed frame relative to the ground-fixed frame. In 
Step (3), this velocity will be defined more carefully. The result of 
Steps (1) and (2), above, is 


4rp' (x,t) 


1 <L 
c at 



I Af 1 5(f) dj; 


I Vf 15(f) d ? (2.5-10) 

T* 

Here the integrals are evaluated in the blade-fixed frame over the entire 
space. The source time, r*, is the emission time obtained by finding the 
root of the equation 


+ / 


r 2 1-M_ 


g = r* - t + lx - y(>7,T*) l/c=0 


(2.5-11) 
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For subsonic propellers considered here, this equation has only one root. 


Step (3) : In this step, the Integrations over the delta functions In 

Equation (2.5-10) are performed by using the relation 

d? ■ (2.5-12) 


where at this stage dS is the element of surface area of the surface f = 
constant. This relation is derived in Reference 2.5-2. Substituting Equa- 
tion (2.5-12) into Equation (2.5-10) and integrating with respect to f 
results in the following equation: 


4*p'(x,t) 


1 <L 

C 0t 


I 

f=0 



dS + / 
f=0 



(2.5-13) 


Here, M r = v-jr-j/c, where v is the local velocity of points on the blade 
surface itself. Since M r < 1 for all points on a subsonic blade, the 
absolute value about 1 - M r will be dropped in the following formulas. 

Equation (2.5-13) has been used for high speed propeller noise calcu- 
lations by Farassat (Ref. 2.5-4). For subsonic propellers, since M r < 1, 
the time derivative is taken inside the integral since the following terms 
are functions of time in the first integral of Equation (2.5-13): 

A 

1 ^ 

1 ; r(l-M f ) ; r(l-M r )‘ 

The chain rule of differentiation is then used to differentiate the inte- 
grand of the first integral in Equation (2.5-13): 
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(2.5-14) 


9 9 r* 9 

9t " 9t 9t* 

From Equation (2.5-11), by differentiating with respect to t, the 
Is obtained: 


9r* 1_ 

9t ' 1-M r 


Therefore, from Equation (2.5-14) 


9_ L. JL 

9t ' 1-M r 9r* 


The following relations are thus established: 



A 



9t* 


r . v -v. 
i r i 


3M r 
9 r* 


JL 

cr 


9v i 2 
r 1 9r + v r 


v 


2 


following 

(2.5-15) 

(2.5-16) 

(2.5-17) 

(2.5-18) 

(2.5-19) 
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Using Equation (2.5-16) through (2.5-19), the time derivative In Equa- 
tion (2.5-13) is carried out explicitly to give: 


and 


4Tp'(x,t) = J / 
L c f=( 


Vj 

r(l-M r ) : 


dS 


Jr* 




’r - ¥l 


r 2 (l-M r ) 2 


dS 


+ c / 
c f=0 


1 r (rA.r.+cM r -cM 2 ] 


r 2 (1-M r ) 3 


dS (2.5-20a) 


4rp'(x,t) = / 

f=0 


o v [ rPl . r . 
o nl l i 


+ cM r - cM 2 ] 


r 2 (l-M r ) 3 


dS (2.5-20b) 


Jr* 


p' (x,t) = p^(x,t) + Pj(x, t) 


(2.5-20c) 


I I 

where p|_ and pj denote the loading and thickness noise, respectively. 
Equations (2.5-20a) through (2.5-20c) are used when the sources on the 
full -blade surface are specified. They are related to an equation derived 
by Woan and Gregorek (Refs. 2.5-4 and 2.4-5). 

The symbols M-j and are defined as follows: 

M i = ^ (2.5-21) 
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(2.5-22) 


A, 





c 


Note that v-j and v-j are the local velocity and acceleration of the blade 
with respect to the ground-fixed frame. It Is assumed here that the 
propeller blades are rigid. It is important to note that li is the rate of 
change of the vector 1-j as seen from the ground-fixed frame. This means 
that even if li is steady in the blade-fixed frame, li is not zero. 

The force intensity vector li can be written as 

1 ^ = pn i + a t.. (2.5-23) 

where p is the surface pressure defined as Pa - Po« Here Pa is the abso- 
lute surface pressure and Pq is the ambient pressure in the undisturbed 
medium. The local tangential stress is denoted by a. Also the unit ^ 
tangent vector pointing toward the section leading edge is denoted by ti . 
From Equation (2.5-23), the rate of change of li is found to be 

*i = pn i + pn i + at 1 + at ^ (2.5-24) 

It can be shown that 

n^ = (il x"n)| (2.5-25a) 

and 

A 

*,.(8x1), (2 . 5— 25b) 
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From Equations (2.5-24) and (2.5-25), the following results are obtained: 


# A • • 

1^ = pcostf + a cos0' + pTj + aT 2 


(2.5-26a) 


1. r^ = pcosfl + acos9‘ 


(2.5-26b) 


and 


■ P M n + ""t 

A A 

Note that 9 is the angle between n and r, 9' is the 

A 

r-j, and Tj_ and T2 are defined as follows: 

Tj = r • (3 x n) 

T 2 = r • (5 x t) 


(2.5-26c) 

angle between t-j and 

(2.5-27a) 

(2.5-27b) 


Also Mt is defined as M-jt-j/c. Equation (2.5-26) is substituted into Equa- 
tion (2.5-20) and the results discretized for numerical calculation. 

A useful approximation to Equation (2.5-20) will be written next. 
Assuming that the propeller blades are thin, the acoustic sources can be 
moved to the mean surface of the blades. The mean surface is defined to be 
that surface formed by generating the section mean curves along the leading 
edge curve. Let the surface be denoted by the equation f m (x,t) = 0. The 
FW-H equation becomes 

7 ' ,2p ' = 2 [Vnl 7f J s < f n>>] 

+ a!: (2-5-28) 


01-168-86 


2-140 



where Ap « Plower - Pupper a nd n 1m 1s the unit normal to f m = 0 pointing 
toward the upper side of the blade. Here v n Is the local normal velocity 
of the blade on one side of the mean surface due to thickness distribution 
alone (i.e., the camber effect is Ignored). Note that v n is calculated by 
evaluating v n at each upper surface point and v n at the corresponding point 
on the lower surface and then averaging. Furthermore, skin friction is 
neglected. 

Following a procedure similar to that leading to Equation (2.5-20), we 
obtain an expression for p'(x,t): 

Ap cos0 + AplJ 


4*p.' (x,t) = - £ / 

L f =o 

m 


i 

f _ = ° 
m 


[Ap(cos0-M n )' 
r 2 (1-M ) 2 


dS 


c f Jo 


r • ^ 2 

Ap cos0 J^rM. r.. + cM r - cM 


r 2 (1-M r ) 3 


dS (2.5-29a) 


4Tp|(x,t) = / 

T V 


2p o V„K ?| * cM r - CM 2 ) 


r 2 (l-H r ) 3 


dS (2.5-29b) 


and 


p 1 (x , t) = p^x.t) + p-j-(x.t) (2.5-29c) 

A 

In Equation (2.5-29a), 9 is the angle between the radiation vector n and 
n im* 

Two compact-source approximations for the subsonic propeller noise 
calculation will also be used. In the first approximation, each blade is 
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replaced by a single point source involving both the thickness and loading 
effects. The loading noise formula of Lowson and the thickness noise form- 
ula of Succi are used (Refs. 2.5-6 and 2.5-7). Let Lj be the net force by 
each blade on the fluid and $ be the net volume of each blade. Then the 
loading and thickness noise are calculated from: 


4*-p^(x,t) = 


cr(l-M r )‘ 


r-L- + 
1 l 


r i L i 


V 7 (i-M 2 ) 


- M.L. 
r l i 


ir = r* 


= F L (x,t,R E ) 


(2.5-30) 


and 


4Tp|(x,t) = 


f V 


r(l-M r ) 


(1-M r ) 


L 'fi r - 3 £ fi.fi 


+ 3 S M r] 2 + 3 ( fl r - f 


f ( fl r - 7 "*) ( 1+4M r + H ?)] 


(2.5-31) 


t = r* 


- F j(x,t, R^) . 


Here the sources are assumed to be located at some effective radial dis- 
tance Re (usually about 0.8 radius of the propeller). The effect of each 
blade is computed separately and summed to get the total noise. 

A second compact-source formulation is obtained by assuming that each 
blade can be approximated by a line source (chordwise compactness 
assumption). In Equations (2.5-30) and (2.5-31), let L^) and A(ft) be 
substituted for L-j and #, respectively, and represent the force per unit 
distance and blade volume per unit distance. Here is the radial 
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distance in the blade-fixed frame. The noise due to loading and thickness 
of the propeller is then given by 


4«p'(x,t) - R /° [[F^(x,t,e a ] * ( F T(x- t .fl)] d «l (2-5-32a) 


1 1 

where the integrands F|_ and Fy are defined 


by 


F£ (x.t,^) - 


cr(l-M r )‘ 


+ TO IK + r d-" 2 )] 



(2.5-32b) 


and 


Fj (x.t,^) 


P^j 1 > 

r(l-M r ) 4 





+ 3 



2 


+ 3 (ft r - 7 M 2 ] 2 + f (fi r - 7 M 2 ) [l + 4M r + M 2 )j (2.5-32C) 

The symbols Ri and R 0 in Equation (2.5-32a) represent the inner and the 
outer radii of the blade. The effect of several blades is taken into 
account by a method requiring a single blade calculation as discussed 
below. 

2. 5. 2. 2 Frames of Reference 

In this section the coordinate frames used in the acoustic 
calculations will be discussed. Basically there are two reference frames: 
the ground-fixed x-frame and the blade-fixed 17 -frame. The x-frame which 
remains fixed to the undisturbed medium is set up as follows: 

• The origin of this frame is at the propeller center at time t=0, 
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• The propeller disk Is in the xiX2-plane and the X3 axis coincides 
with the propeller axis, with positive direction in the flight 
direction. 

• The xj-axls Is assumed to be orthogonal to X3, upward and parallel 
to the plane of symmetry of the aircraft. 

• The x?-axis is defined in such a way that the x-frame is right- 
handed (Figure 2 . 5 - 1 ). 

The observer position is always specified in this frame as will be 
explained shortly. 

The blade-fixed frame is set up as follows: 


• The origin coincides with the origin of the x-frame at t= 0 . 

• The 73-axis coincides with the X3~axis. 

• The 72-axis lies on the pitch change axis of the blade. 

• The > 7 i> 72 “Pl ane normal to the propeller shaft. 

• The 71-axis is defined to make the 7-frame right-handed 
(Figure 2 . 5 - 2 ) . 

Note that the blade mean surface does not lie in the 7172-plane but 
makes an angle equal to the geometric pitch angle at each radial position. 
Note also that the 7-frame rotates with angular velocity, Q. 

In the acoustic formulas presented in the previous section, many oper- 
ations involving dot products or cross products of two vectors are 
required. When the products involve blade normals or surface pressures, it 
is convenient to transform the components of these vectors to the 7-frame 
and then perform the operation. However, note that the source position y 
always refers to a source point in the x-frame with a known position 7 in 
the blade-fixed frame. The quantities r = x-y and r = r/r are calculated 
in the x-frame, and then the vector components are calculated in the 
7-frame. Note that for any variable which has a velocity term, such as M r 
= M-jrj and v n = v»n, the velocity is with respect to the x-frame. In other 
words 


v 


i 


9 r 


( 2 . 5 - 33 ) 
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The components of this vector must then be calculated In the i^-frame to get 
M r and v n . 

Another frame of reference which is used conceptually is the aircraft- 
fixed nonrotating ^-frarne. This frame coincides with the ground-fixed 
x-frame at t=0. The acoustic pressure p'(^,t) for an observer in the 
aircraft-fixed frame with the position vector t is found as follows. Since 
both t and t are known, the relative position of the ground-fixed frame and 
the aircraft-fixed-frame is known is calculated. From this, the observer 
position x in the ground-fixed frame. Using this x and t, p'(x,t), which 
is the same as the acoustic pressure at position t in aircraft-fixed frame 
and at time t is calculated. Thus, the ^-frame itself is never used in 
acoustic calculations, even though the pressure signal that results is 
p'S.t). 

The transformation from one frame to the other at time t can be writ- 
ten in matrix notation: 


r-H 

X 


cos^ -sin^ 0 


‘ ’l ' 

C\J 

X 

II 

sin^ cos^ 0 


*2 

CO 

X 


0 0 1 


. ’3 . 


' X 1 ' 


' X 1 ' 


' 0 ' 

X 2 

= 

x 2 

+ 

0 

. X 3 . 


. X 3 . 


. V. 


(2.5-34a) 


(2.5-34b) 


where ( *71 , rj2, 173) is a point in the rotating ^-frame, (X^, X2, X3) is the 
corresponding point in the moving X frame, (xj, X2, X3) is the correspond- 
ing point in the ground-fixed frame, and ^ (=Qt) is the angle between the Xi 
and rji axes. 

A final coordinate transformation is necessary to account for changes 
in the root pitch setting. This rotation through a small angle, 9 0 , is 
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applied to the blade surface coordinates which are calculated by the geo- 
metry generator module. 



' COS0Q 0 sin 0 Q ' 


r !\ ' ! 


0 10 


*1 


-sin0Q 0 cos0q 


^2 ' ^1' ^2^ 


( 2 . 5 - 35 ) 


Whenever the 17-frame or pitch axis coordinate system is mentioned herein, 
it is assumed that the above corrective transformation has occurred. Often 
the Geometry Generator Module and propeller noise module will be executed 
without change to the collective pitch setting. Thus, 0 o =O and the last 
transformation is unnecessary. 

2 . 5 . 2. 3 Computational Strategy 

A pressure time history of a multi bladed propeller is calculated by 
summing the acoustic pressures of each blade as a function of time. The 
signals are periodic because the observer position is a fixed distance from 
the hub at all times. Thus, the signal produced by one revolution of a 
single blade can be used to determine the time history and spectrum of the 
propeller. The general computational strategy is outlined below. Details 
concerning the different methods for calculating p'(X,t) are contained in 
later sections. 

The steps involved in calculating the acoustic time signature for a 
single blade are as follows. Assume that the Initial pitch change axis of 
the blade is aligned with the ^ 2 -ax ^ s * That is, assume t = ^ = 0 and the 
x-frame, ^-frame and 17-frame coincide. Divide the time required for one 
full revolution of the blade into even time increments such that 


Likewise, represent the blade by a set of source points, 7 ( j ) , where the 
number and location of the source points depends on which method for 
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calculating noise is selected. Then, for each time, ti, and each source 
point, ^(j), determine the source, y, and observer, x, locations in the 
ground-fixed frame. Using these, solve the retarded time equation and 
calculate distances and velocities at emission time. Next, calculate 
vector components in the rotating 7-frame and calculate the influence of 
this source point on the total noise. Finally, accumulate the information 
for each time and source point into a complete time history. 

The steps involved in producing a time history and spectrum for the 
propeller are as follows: 

• Tabulate the time history for one blade so that intermediate 
values can be obtained by interpolation. 

• Decide how many evenly spaced time points are required by the FFT 
procedure. If Ns is the highest harmonic number of interest and 
Nt the number of time points, find an integer m such that 2 m is at 
least as large as N^ 2 2 N s ; 

• Calculate the total acoustic pressure-time history by adding the 
contribution from each blade; 

• Finally, perform an FFT to get the pressure spectrum. 

The above process can be stated mathematically as follows. The time 
required for one revolution of the blade is divided equally into 2 m points 
such that 


t = (Kill 

k ( 2 m ) Q 


k = 1, 2, ... 2 


m 


m = INT (log 2 N t ) + 1 


(2.5-36) 


where the INT function turns a real number into the largest integer not 
exceeding the real number. 

The acoustic signal generated by a propeller is just the sum of the 
pressures produced by each blade. The pressure produced at time t by blade 
b which had an initial angle ^5 = ifi 0 + 2* (b - 1)/Nb relative to the ^ 2 
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axis, can be found by interpolating into the single blade pressure table 
for p'(X, t+^b/Q)- Thus, the total acoustic signal is 


P T (*.t k ) ■ Z P'(*,t k + # b /0) , (k * 1.2.- -Z") (2.5-37) 

b=l 


where t is the observer position in the aircraft fixed frame, Nb Is the 
number of blades, and is the initial position of each blade. The spec- 
trum associated with this time history is calculated by using a standard 
FFT routine. Section 2. 5. 2. 9 contains further details. 

2. 5. 2. 4 Retarded Time Equation 

This section describes a method for solving the retarded time equa- 
tion, g = r-t + r/c = 0. As noted above, the root r = r* of this equation 
must be found for each source point used to represent the blade and for 
each observer time, t. Since the roots of the equation are calculated 
repeatedly, it is imperative to solve the equation in an efficient way. 
Details of the solution technique are reserved for Section 2. 5. 2. 8 . 

The problem can be stated in terms of arbitrary receiver location x, 
and source location, y defined in the ground-fixed coordinate system at 
time t. As described in Reference 2.5-4, the equation can be written 

r2 = x 3 + d x + d y ‘ 2 d x d y cos (flr + 1 *y “ ^ 

+ VpT 2 - 2x V f t = c 2 (r-t ) 2 (2.5-38) 

where dx and dy are the radial distances between the X 3 axis and the obser- 
ver and source points, and ^ x , ^y are the observer and source angles of 
rotation at t = 0. For instance, if the source point is located on the 
pitch change axis then dy = rj2 and fy = 0 (Figure 2.5-2). 
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X 



Figure 2.5-2. Geometry of Source and Observer Position Used for 
Calculation of Emission Time 


01-168-86 


2-150 



After some manipulation, 


r 2 = (x 3 - V F t) 2 + d x 2 + dy 2 = 2d x d y cos [Q(r-t) + * y - (* x - tit)] 

+ V 2 (r-t) 2 - 2Vp(x 3 -Vpt) (r-t) = c 2 (r-t) 2 (2.5-39) 

Let ip = tl(r-t), then Equation (2.5-39) Is of the form 

A^ 2 + Elf + C + cos(^ + D) = 0 (2.5-40) 


where 


A = ( C 2 - V 2 )/[2n 2 d x d y ) A > 0 
B = Vp(x 3 - Vpt)/(Qd x d y ) 

C * - [(*3 - V F t ) 2 + d x * “yl^xV 
0 * ty - *x * 0t 


Based on the transformation given in Equation (2.5-34b), the term (x 3 -Vpt) 
can be replaced by the constant X 3 for all times. Consequently the coeffi- 
cients A, B, C in Equation (2.5-40) change only if source position changes. 
Thus, the solution to Equation (2.5-40) for one source point and source 
time will be a good initial guess for the same source point at a slightly 
later time. 

Equation (2.5-40) can be solved very efficiently using Newton's 
method. Only the root such that (r-t) < 0 is physically possible. 

However, with a good initial guess, Newton's method will converge to the 
proper root very quickly. 
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2. 5. 2. 5 Full Blade Formulation 


This section discusses the calculation of the periodic acoustic pres- 
sure signal for a single rotating blade with subsonic tip speed. The met- 
hod described requires a detailed knowledge of the blade geometry and blade 
surface pressures. The following two sections discuss simplifying approxi- 
mations to the full blade formulation which are used in the absence of full 
blade information. 


The acoustic pressure at time t for an observer at point x is given in 
Equation (2.5-20) and repeated here. 


4*p'(x,t) = £ / 

L c f=0 


V, 


r(l-M r )‘ 


dS 


\lo 


V - ’i"i 


r 2 (l-M r ) 2 


dS 


+ 7 J 


f=0 


l^rfy r i + cM r - 


cfT 


r 2 (l-M r ) 3 


dS, (2.5-41a) 


4*P{(x,t) = / 

f=0 


'nK ? 1 


Pn V nl rM i^ + CM r - C M 2 ) 


r 2 (1-M r ) 3 


dS (2.5-41b) 


Jr* 


with 


4rp 1 (x, t) = p^(x,t) + p^(x,t) 


(2.5-41c) 
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Using symbols F L1 , F L2 , and F L3 to stand for the Integrands which are 
evaluated at retarded time t*, the above equation Is written in short form, 


= C F |_l® dS + f l 0 F L2^ dS + c f l 0 F L3^ dS (2.5-42a) 


4tp| = F t (?) dS (2 - 5— 42b) 

1 f=0 1 


Using the Geometry Generator Module, the surface of a propeller blade is 
described by a set of points jjj. The three components of each point ijj are 
tabulated with respect to spanwise and chordwise station parameters and 
(Figure 2.5-3). Thus each term in Equations (2.5-42) may be replaced by 
an equivalent double integral over fi and f 2 . For instance, 

J F l ,(?) dS = / J F L1 (5 (^i , €2) ) J d ^2 d ^l (2.5-43) 

f =0 0 0 

where J is the Jacobian of the transformation. 


J 




(2.5-44) 


Equation (2.5-43) is evaluated by using a compound rule. Thus, 


1 


I 

0 


2 * 

I F 
0 


LI 


J d £ 2 d£ x = r G L1 (Cj) dCj 


(2.5-45) 


where 


G L1<«1> = f F Ll ( fl' «2> J( «l' «2> d «2 (2 - 5 ' 46) 

Each of the integrals over a single parameter is evaluated using a standard 
procedure based on cubic splines. 
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ni 



Figure 2.5-3. Blade Surface Coordinate System 
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Conceptually, the process of evaluating Equation (2.5-41) to get 
p'(x,t) involves calculating the values of each Integrand at a set of blade 
surface points 17 (j) and accumulating them In a way that gives a suffici- 
ently good approximation to the Integral. 

2. 5. 2 . 6 Mean Surface Approximation 

In this section, approximation formulas for noise calculations based 
on the assumption of thin airfoils are presented. The mean blade surface 
is defined to be that surface generated by the totality of mean section 
curves. The calculation procedure is derived from Equation (2.5-29) which 
are repeated here for convenience: 


4xp' (x,t) = - 7 J 

L f=( 

m 


Ap cos0 + ApTj 


r(l-M r )‘ 


dS 


Jr* 


and 


I 

f =0 
m 


Ap(cos0-M n ) 


r 2 (1-M r ) 2 


dS 


Jr* 


7 J 


f =0 
m 


Ap cos0 (Vft. r. + cM r - cM 2 j 


r 2 ( 1 -MJ 3 


dS, (2.5-47a) 


4rp|(x,t) = / 

1 f =( 


2p 0 v n [rfl 1 r, + c H r - CM 2 ) 


r 2 (l-M r ) 3 


dS (2.5-47b) 


Jr* 


p' (x,t) = p^x.t) + p|(x,t) 


(2.5-47c) 


We deal first with the thickness noise integral, Equation (2.5-47b), and 
derive equations for the various terms of the integrand as functions of 
known quantities. 
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Coordinates of Mean Surface 


For a given radial distance, fj, allow f 2 to vary In the range 0 i ^ 
i r and define a mean section line as 

ViUy e 2 ) = \ e 2 ) + 2t - e 2 )i. o = 1,2,3) (2.5-48) 

Differential Element of Mean Surface 

In terms of the independent variables and f 2 , the differential area 
element, dS, is given by: 


dS = J(£ r e 2 ) d£j de 2 = J EG - F 2 d^ d^ (2.5-49) 

The symbols E, F, and G are written in terms of the mean surface coordi- 
nates as follows: 


and 


9*7j 

2 

j 

9^2 

2 

x 

dr l 3 

L^iJ 

T 

l 8 «J 

T 

NlJ 


9^1 9^1 9^2 9^2 9? 3 9? 3 

W z + »£j a« 2 + »?! 


G = 


9 Vi 

2 

9j? 2 

2 

a, 3 


+ 

kJ 

4* 



(2.5-52) 
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We recall that 17 2 = $1 and thus rj 2 Is Independent of { 2 - Equations 
50) and (2.5-51) therefore simplify to 


and 



2 

1 

8 *3 

kJ 

T 

kJ 


37j aijj 3l ) 3 873 


Velocities and Mach Numbers 

The position of a point on the blade is obtained by using the 
formation defined by Equations (2.5-34) 


h ' 


cos fit - sin fit O' 


’l ‘ 


' 0 ' 


= 

sin fit cos fit 0 


V 2 

+ 

0 

CO 

>> 


001 


. ^3 . 


. V. 


The velocity of such a point is therefore expressed as 



V 1 


h 


-sin fit - 

cos fit 

0 


^1 


0 

-f 

V = 

V 2 

= 

h 

= a 

cos fit - 

sin fit 

0 


>?2 

+ 

0 


. V 3 . 


. h . 


0 

0 

0 


. ’3 . 


. V F. 


(2.5- 


(2.5-53) 


(2.5-54) 


trans- 


(2.5-55) 


(2.5-56) 
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The position of a source point on the mean surface Is, by analogy with 
Equation (2.5-55), given as follows: 


<<1 

M 


cos fit - sin fit 0 


’1 

+ 

0 

*2 

= 

sin fit cos fit 0 


V 2 

+ 

0 

. *3 . 


0 0 1 


. h . 

+ 

. V F t . 


(2.5-57) 


The unit normal to the mean surface is 


n = 

9£l 


52 Z_ 

h 2 


/ 


3 fl 3 <2. 


(2.5-58) 


and the unit vector in the radiation direction from a point on the mean 
surface is written as 


r 




(2.5-59) 


By analogy with Equation (2.5-56), the velocity of a point on the mean 
surface is represented by 



-sin fit - cos fit 0 


’1 


0 

n 

cos fit - sin fit 0 


V 2 

+ 

0 


0 0 0 


. ? 3 . 


. V F. 


(2.5-60) 


The acceleration therefore becomes 


dv 



-cos fit sin fit 0 


’1 

fi 2 

-sin fit - cos fit 0 




O 

o 

o 


. ’3 . 


(2.5-61) 
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Hence the local Mach number and its time rate-of-change are given by: 


M 1 ■ 


M 2 

_ n 

c 

. M 3. 



•sin flt - cos tit 0 
cos nt - sin nt 0 
0 0 0 



’l ■ 


' 0 ' 


V 2 

+ I 

c 

0 


. *3 . 


. V F. 


(2.5-62) 


and 


■cos nt - sin Qt 0 
-sin nt - cos nt 0 
ooo 

The mean normal velocity and radiation Mach number are written as. 


• 


M i 


b 2 

.a! 

c 



K. 




*1 


v 2 


. *3 . 


(2.5-63) 


n ” 2 


v e 2 ) • n (e r e 2 ) + v (e r 2*- - e 2 ) • n u v ^ - y] 

(2.5-64) 


and 


M = M 


L 1] . - - 

• lx - yJ / x - y 


Miscellaneous Integrand Terms 

The differential pressure, Ap, is defined to be: 


(2.5-65) 


Ap = pU r f 2 ) - p(£ r 2ir - f 2 ) 


(2.5-66) 
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, and F having the definitions given by Equations (2.5-50) and 




2. 5. 2. 7 Compact Chord Approximation 

In this section, approximation formulas based on the assumption of a 
line source are presented. The basis for the calculation procedure Is the 
set of Equation (2.5-32) which we recall for our use 


where 


■O’ 

4*p' (x,t) = / [^(x.t^J + F-j.^x,t,fjj j (2.5-71) 


R i 


F^x.t.fj) 


cr(l-M r )‘ 


Vi + K + f^ 2 )] 


(1-M r ) 


- M.L! 
r l 1 


(2.5-72) 


and 


fd-V K - 3 r ^ + 3 (r M r) 2 


r(l-M r ) 


3 ( fl r - I " 2 ) 2 * f ( fl r - 7 " 2 ) ( 1+4 V M r) 


(2.5-73) 


Considering Equation (2.5-73), we observe that the quantities ft, ft, M r , and 
r are computed as in Equations (2.5-55) through (2.5-64) of the mean- 
surface approximation section. We take as our line source the leading edge 
curve of the propeller, so that all positions, r, are on the leading edge 
curve. The quantity A(fj) which represents the blade volume per unit 
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radial distance Is equivalent to and numerically equal to the cross- 
sectional area of a given blade station. This quantity is calculated as a 
one-dimensional Integral by using Stoke' s Theorem. The value is 


A(e x ) 


= J 


^2 



(2.5-74) 


Next we examine the loading given by Equation (2.5-72). The key quantities 
to be calculated in this expression are t' and dt'/dt which represent the 
loading per unit length and its time rate-of-change. The loading per unit 
length is given by 


' L 'l ' 


-cos Qt F^(^,t) 

L '2 

= 

-sin Qt F^(£ lt t) 

L' 


; F ( *l' t} 


(2.5-75) 


where and F z are provided by the loading module. The time rate-of- 
change of t' becomes 


d_ 

dt 


4 j 


-fl sin Qt F^ - cos Qt g^ 


»F # 

-Q cos fit F^ - sin Qt 


5 

l at 


(2.5-76) 


The quantities 3F^/3t and 5 F z /9 1 must be calculated as needed. 

2. 5.2.8 Point Source Approximation 

In this section, approximation formulas based on the assumption of a 
single noise source representing each blade are presented. The basis for 
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the calculation procedure is Equation (2.5-30) and (2.5-31) which we now 
recall 


(2.5-77) 


4*p L (x,t) 


cr(l-M r )‘ 


r i L i 

r - t i + TI^J 


S r + f (l-H ) 


r M 1 L 1 


T = T* 


and 


4*p T (x,t) = 


f Po* 


r(l-M r ) 


[(l-M r )(*M r - 3 ^ fJi-M) + 3(f M r ) 2 + 3(M r 


f M 2 ) 2 


+ 7 (M - 7 M 2 )(l+4M r + M 2 )] 


(2.5-78) 


r = r* 


The local quantities such as r, M, M r , etc., are evaluated at some effec- 
tive radial distance, ft = Re, usually about 0.8 of the propeller radius. 
We now derive explicit expressions for the various terms on the right-hand 
side of Equations (2.5-77) and (2.5-78). We begin with Equation (2.5-77); 
the effective blade load is given by 


' L 1 ' 


-H cos (It 

L 2 

= 

-H sin (It 

. L 3 . 


T 


(2.5-79) 


where H and T are the azimuthal force and net thrust from a single blade 
and are provided by the loading module. The time rate-of-change of L 
becomes 


• 

L 1 


-(1H sin (It -H cos (It 

4 

= 

-OH cos (It -H sin (It 

. 4 . 


t 


(2.5-80) 
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The quantities fi and T must be calculated as needed. If it is assumed that 
the effective source point Is located on the leading edge at the effective 
radius, R E , then the local Mach number at this point is given by 


V 

_ n 

c 

-sin fit 

- cos flt 

0 ' 


>7i^( r e) 


‘ 0 

M 2 

cos flt 

- sin flt 

0 


r e 

+ 

0 

M 3 . 


0 

0 

0 


7 3 ^( R E ) 


V p/c 


(2.5-81) 


The first and second time rates-of-change become: 




-cos flt sin flt 0 


«7i£( R E ) 

*2 

- £ 2 
c 

-sin flt - cos flt 0 


r e 

fi 3 . 


0 0 0 


7 3j ^( r e ) 




sin flt cos flt 0 


7l£( R E ) 


- £ 3 
c 

-cos flt sin flt 0 


r e 





1 7 3 g.( R E ) 

M 3 J 


O 

O 

o 
1 



(2.5-82) 


(2.5-83) 


The position of the source is provided by 


*1 ' 


cos flt 

- sin flt 

0 ‘ 


«7i£( R E ) 


' 0 ' 


= 

sin flt 

cos flt 

0 


r e 

+ 

0 

y 3 . 


0 

0 

0 


»? 3 ^( R E ) 




(2.5-84) 
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and the unit vector in the radiation direction Is given by the usual 
expression 
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The unit vector derivatives are expressed as: 


( 2 . 5 - 89 ) 
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and 


r = 


• • 

-► 

y • r 


(2.5-91C) 


► • 

r = 


• • 

-► 

y 


•¥ 

r + 


-► .2 

1 

r I 


•* •+• 

y • r 


(2.5-91d) 


The remaining quantity to be evaluated is the blade volume,, which is by 
definition: 


* = / dV 


(2.5-92) 


By use of the divergence theorem, this can be expressed as a surface inte- 
gral 


9 / J dV = / n ? dS, 

f =o J J 


(2.5-93) 


A 

where 03 is the component of the unit surface normal in the direction of 
03 . Equation (2.5-93) can be further expressed as 

1 2r 

* “ / / «? 3 (e lf e 2 ) n 3 (e 2 .e 2 ) d tv (2.5-94) 

where the Jacobian, J, is defined to be 


J = 


SL x SLl 

afj a{ 2 l 


(2.5-95) 


2. 5. 2. 9 Roots of Retarded Time Equation 
The retarded time equation is written 


+ C + cos(^+D) = 0 


(2.5-96) 
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where only the root (0/Q) < 0 is of interest. Since both Equation (2.5-96) 
and its first derivative have an oscillating term, a close initial guess is 
required to ensure the convergence of Newton's method. This is accom- 
plished by replacing the cosine term by a parabola and solving the result- 
ing quadratic equation. Details are given below. 

Step 1. Bracket the Root 

Figure 2.5-4 illustrates that the roots of Equation (2.5-96) are the 
intersection of a parabola and a cosine curve. As a first approximation to 
the root, find <p\ such that 

V 2 + B ^1 + C = 0 (0i < °) (2.5-97) 

Next determine which half cycle of the cosine curve to replace by a quadra- 
tic. Let 


INT + D)/ir] if (^ + D) 1 0 

INT Oj + D)/t] - 1 if (0j + D) < 0 


(2.5-98) 


where Z is the integer half cycle number and INT stands for the truncation 
integer function. 

Step 2. Determine Initial Guess 

The cosine term is replaced either by a straight line or by a parabola 
depending on whether Z is an even Integer or an odd integer. 


-0 - D + (Z + 1/2)t 

cos(^+D) = 

1 - 4[0 + D + (Z+1)t] 2 /x 2 


if Z even 
if Z odd 


(2.5-99) 


With the above substitution, Equation (2.5-96) can be solved, using the 
quadratic formula, to give an initial guess fa- 
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Step 3. Newton's Method 

The roots of Equation (2.5-96) can now be determined through an Iter- 
ative process, 


\k<t>l + Bi + C + costy + D)1 

. . L r n _n M] J. /o c.inn^ 

^n+l = ^n [2A^ n + B - sin(0 n + D)] (2,5 } 

which terminates when l^n+1 ~ ^nl 1S smaller than a user specified conver- 
gence criterion or, if the number of iterations exceeds a limit set by the 
user. 

Step 4. Return Answer 

If (^ n +i/Q) < 0 or if ^ n +i substituted in Equation (2.5-96) does not 
return a value less in magnitude than a user specified tolerance, then an 
error condition results; otherwise, 0 n+ i = Q(r*-t). 

Note that the retarded time equation is solved for one source point at 
many receiver times. Thus, ^n+1 ma y be a close initial guess to the next 
required root. In this case, Step 1 and Step 2 can be skipped. 

2.5.2.10 Acoustic Spectrum Calculation 

The acoustic spectrum is attained by calculating the amplitude of the 
complex coefficients of the Fourier series for pp(x,t). A standard FFT 
routine based on the Cooley-Tukey algorithm is used for this purpose. 

Let N s be the number of harmonics desired. Find m such that 2 m_ l < 
2N S i 2 m and form the complex array: 

Zj = (Pp(x,tj), 0) , (j = li 2, ..., N^-l) (2.5-101) 


where 


N t = 2 m and t. = (2xj/N t ) 


(2.5-102) 
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Now find the inverse Fourier transform 


Nfl 

c = A- 2- Z,e" 2TlkJ/N t (k = 0, 1,... Nj (2.5-103) 
N t j=0 J 1 

The acoustic spectrum is given by 


SPL, = 10 log [2 


2 ,2 -| 

/p ref^ 


(k = 1, 2,... N ) 


(2.5-104) 


2.5.2.11 SPN Input 

The computation of subsonic propeller noise requires data of the blade 
shape characteristics, aerodynamic characteristics, flow and operating 
parameters and observer geometry. The noise signature is calculated using 
(1) full blade formulation, (2) mean surface approximation, (3) compact 
chord approximation, or (4) compact source approximation. Option numbers 
in parenthesis identify the inputs which correspond to each method. 


B 


Nb 

N S 

Vp 

^o 

*o 

a 


User Parameters (1, 2, 3, 4) 

Blade length measured from axis to tip, m (ft) 
Number of blades 
Highest harmonic number desired 
Aircraft forward velocity, m/s (ft/s) 

Root pitch change angle, rad 

Initial azimuth angle of first blade, rad 

Angular velocity of blade, rad/s 
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Blade Shape Table (1. 2. 3, 4) 


Cl 

C2 

Vlttl' £ 2 ) 

>73 (Cl » C2) 

*li *2 


V i (Cl) 
v 3 (Ci) 


Spanwise location, normalized by B 
Chordwise location, rad 
Blade surface abscissa, normalized by B 
Blade surface abscissa, normalized by B 
Slopes of basis functions at nodes 
Leading Edge Table (3) 

Abscissa of leading edge, normalized by B 
Abscissa of leading edge, normalized by B 
Aerodynamic Characteristics Table (1, 2) 


Spanwise location, normalized by B 
Chordwise location, rad 
Azimuthal location, rad 
Pressure loading normalized by /> 0 (Bfl) 2 
ff (Ci, y) sk1n function loading, normalized by p 0 (Bfl) 2 

Observer Table (1, 2, 3, 4) 

x Initial observer position, m (ft) 


Cl 

C2 

t 

p(Ci. C 2 . t) 
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Performance Characteristics Table 
F z (j>) Axial section force, normalized by /> 0 B 3 ( 3 ) 

Azimuthal section, normalized by /> 0 B 3 q2 (3) 

Net thrust for a single blade, normalized by /3 0 B^fi2 (4) 

Net azimuthal force for a single blade, normalized by p 0 B4{]2 (4) 
Effective radius based on net thrust, normalized by B (4) 

Cq(iO Effective radius based on azimuthal force, normalized by B (4) 


T(f) 

H(l») 

eiw 


2.5.2.12 Program Validation 


The SPN program has been verified for both near-field and far-field 
conditions by comparison with experimental data for the 101/16 and SR-3 
propellers. Near-field data for the 101/16 propeller were taken in flight 
using a wing-mounted microphone on an Aero-Commander (Ref. 2.5-8) as shown 
in Figure 2.5-5. Pressure signatures and overall noise spectra for three 
different microphone boom positions (X3), as calculated using SPN, are 
compared with flight data in Figures 2.5-6 through 2.5-11. Also shown for 
comparison purposes are calculations carried out at Ohio State University 
using the Woan-Gregorek code (Ref. 2.5-5). Flight Mach number (M«) , pres- 
sure altitude (PALT), number of propeller blades (B) , and propeller RPM (n) 
were as shown in the figures. Overall good agreement of the acoustic pres- 
sure signatures (Figures 2.5-6, 2.5-8, and 2.5-10) with flight measurement 
may be noted in all three cases. In addition, agreement of the noise 
spectra results is excellent for the first five harmonics but decreases 
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Figure 2.5-5. Wing-Mounted Microphone Position 101/16 Propeller 
Acoustic Measurements Near Field 
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ACOUSTIC PRESSURE (N/M^J 


FLIGHT MEASUREMENT 

□ — -Q SPN 

o O WOAN-GREGOREK (OSU) 


Figure 2.5-6. 


Acoustic Pressure Signature 101/16 Propeller Near Field (Run No. 11) 

v? = °vo 17, PALT = 3043 M » B = 3 » n = 1591 rpm, boom position (M) 

XI X2 X3 

0.0 -2.024 -0.279 
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1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 

HARMONIC NUMBER 


Figure 2.5-7. Overall Noise Spectra 101/16 Propeller Near Field (Run No. 11) 

M» = 0.317, PALT = 3043 M, B = 3, n = 1591 rpm, boom position (M) 
XI X2 X3 
0.0 -2.024 -0.279 



ACOUSTIC PRESSURE (N/M 


FLIGHT MEASUREMENT 

Q----0 SPN 

O O WOAN-GREGOREK (OSU) 


Figure 2.5-8. 


Acoustic Pressure Signature 101/16 Propeller Near Field (Run No. 12) 
M« = 0.317, PALT = 3043 M, B = 3, n = 1591 rpm, boom position (M) 

XI X2 X3 
0.0 -2.024 -0.406 



FLIGHT MEASUREMENT 
SPN 
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HARMONIC NUMBER 

Figure 2.5-9. Overall Noise Spectra 101/16 Propeller Near Field (Run No. 12) 

M« = 0.317, PALT = 3043 M, B = 3, n = 1591 rpm, boom position (M) 
XI X2 X3 
0.0 -2.024 -0.406 





LIGHT MEASUREMENT 



(-W/N S3 0‘Z 3« 90) IdS 
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substantially for harmonic numbers greater than five. This is not of 
practical significance, however, since most of the acoustic energy is in 
the first few harmonics. Moreover, the OASPL (overall sound pressure 
level) results for the three 101/16 propeller cases are shown in Table 
2.5-1. Substantially better agreement with flight data of the SPN 
calculation over that of the Woan-Gregorek code is clearly evident. 

Table 2.5-1. OASPL Results - 101/16 Propeller Near-Field Conditions 

N 

(OASPL = lOLogio ]E (^rms/^ref)^'' N = Total number of harmonics) 
n=l 


Run No. 11 

Flight Data 

131.15 dB 


SPN 

131.54 dB 


Woan-Gregorek 

126.85 dB 

Run No. 12 

Flight Data 

130.86 dB 


SPN 

130.67 dB 


Woan-Gregorek 

129.18 dB 

Run No. 13 

Flight Data 

130.95 dB 


SPN 

129.96 dB 


Woan-Gregorek 

127.66 dB 


Turning now to results for the SR-3 propeller, comparison of SPN cal- 
culations and experimental data at 1.5 tip diameters for an eight-bladed 
propeller with an advance Mach number 0.6 and helical tip Mach number of 
0.86 are shown in Figure 2.5-12. Cal culational results shown in this 
figure are those calculated at TRW using NASA-Langley developed aerodynamic 
modules to calculate propeller-blade loading (ANOPP Level 03/01/03). 

Additional near-field results for a two-bladed SR-3 propeller at 0.8 
diameter tip clearance having an advance Mach number of 0.203 and a helical 
tip Mach number of 0.687 are shown in Figures 2.5-13 and 2.5-14. Note the 
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SOUND PRESSURE LEVEL, dB 


o 


WIND TUNNEL DATA 


X- -XANOPP LEVEL 03/01/03 - TRW 


- - - -X- 




Figure 2.5-12. 


-20 0 20 40 60 

AXIAL DISTANCE FROM PROPELLER PLANE, cm 

I I i 

BCD 
TRANSDUCER LOCATION 

. Acoustic Verification Results SR-3 Propeller 

B = 8, pjSR = 61. 3°, M 0 = 0.60, J = 3.06, Mjh = < 



Acoustic Pressure, Pascals 



Figure 2.5-13. Propeller Plane Near-Field Pressure Signature at 0.8 D 
Tip Clearance Radial Location; SR-3 Propeller, N 5 = 2, 
Mg * 0.203, 6700 rpm, Mjh = 0.687 
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Visual Position, X c / D 


Figure 2.5-14. 


8P Harmonic Sound Pressure Level at 0.8 D Tip Clearance; 
SR-3 Propeller, % = 2, Mq = 0.203, 6700 rpm, Mjh = 0-687 
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good agreement of these calculations with experiment for both the acoustic 
pressure signature and the 8P harmonic sound pressure level. 

Finally, a far-field results for the SR-3 propeller are compared with 
experimental data taken In the UTRC ART tunnel for helical tip Mach numbers 
of 0.901 and 0.671 in Figures 2.5-15 and 2.5-16, respectively. Results are 
shown for the 8P harmonic sound pressure level calculated using the NASA- 
Langley ANOPP code as run at TRW, which includes Langley aerodynamic load- 
ing and performance modules. Note the better agreement with data for the 
helical tip Mach number 0.761 case than for the Mach 0.901 case, which is 
as might be expected due to inaccuracies in calculating the transonic blade 
aerodynamics in the Mach 0.901 case. 

2.5.3 Elliptic Coordinate System 

For the acoustics module it is important to be able to interpolate the 
pressure obtained by the airfoil loading module in an elliptic coordinate 
system, as these coordinates are used to model the airfoil since the 
leading edge can be closely approximated by an ellipse. The section data 
are transformed into an elliptic coordinate system through the use of the 
inverse Joukowski transformation. 

The Joukowski transformation, defined by 

h 2 

z = £ + S- (2.5-105) 

maps the airfoil section from the complex z-plane to the complex f-plane 
where £ is given by 


f=be (2.5-106) 

In the f-plane the airfoil shape is nearly circular. Recall from complex 
variables that z = re 1 ^ is the equation of a circle. If $ is constant in 
Equation (2.5-106) then the airfoil shape in the £-plane is exactly a cir- 
cle. In general however, $ is not constant but is a function of 6. The 
values of f are very small so that $ does not deviate very far from a 
circle, however. 
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8P HARMONIC 

SOUND PRESSURE LEVEL, dB (RE: 20 pPa) 



CORRECTED AXIAL POSITION, x c /d 

Figure 2.5-15. 8P Harmonic Sideline Directivity at 4.4 D Tip Clearance 
SR-3 , Nb ■ 4, M 0 = 0.321, 8550 rpm, Mjh = 0-901 
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8P HARMONIC 

SOUND PRESSURE LEVEL, dB (RE: 20 ^Pa) 



CORRECTED AXIAL POSITION, x /d 

c 

Figure 2.5-16. 8 P Harmonic Sideline Directivity at 4.4 D Tip Clearance 
SR-3, N 5 = 2, M 0 = 0.203, 7500 rpm, Mjh = 0.761 
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To find the representation of an airfoil section in terms of j and 0, 
z can be rewritten as 

z = be* +i * + b (2.5-107) 

or in terms of hyperbolic functions as 

z = 2b cosh^ cos0 + i 2b sinh^ sin0 (2.5-108) 

Since z = x + i y in cartesian coordinates, the coordinates of the airfoil 
section x, y are given by 

x = 2b cosh^ cos0 (2.5-109a) 

and 

y = 2b sinh^ sin# (2.5-109b) 

Solving for cos0 and sin0 in terms of x, y, and the following two rela- 
tions are found 


and 


COS0 


2b cosh^ 


(2 . 5- 110a) 


, V 

sin0 = 2b sinhjf 

Using the identity cos 2 0 + s1n 2 0=l together with Equations 
(2 . 5—1 10b) yields 


(2.5-110b) 
(2 . 5-1 10a) and 


ferW + ■ 1 < 2 - 5 - in 

For constant Equation (2.5-111) is the equation on an ellipse with foci 
located at + 2b. Consequently, lines of constant ^ form ellipses in the 
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z-plane. Similarly, a relation for coshji and slnhj* can be found by solving 
Equations (2.5-109a) and (2.5-109b) in terms of x, y, and 9 to yield 

cosh l> = 2THSI5 (2.5-ll2a) 

and 

s1nh 1> ■ (2.5-112b) 

Using the hyperbolic identity cosh 2 ^ - sin 2 ^=l results in 

2 2 

( 2^515 J - ( 2b"ks ) ■ 1 < 2 - 5 - 113 ) 

Equation (2.5-113) is the equation of a hyperbola with foci also located at 
+ 2b. Lines of constant 9 form an infinite set of hyperbolas in the 
z-plane. 

Figure 2.5-17 shows an airfoil section plotted in the complex z-plane 
with the elliptic and hyperbolic coordinates superimposed on the airfoil. 

A description of the airfoil surface is sought in terms of coordinates ^ 
and 9 rather then x and y. 

In mapping the airfoil to the complex z-plane, the leading and trail- 
ing edges must be located in the elliptic coordinate system. Note that the 
derivative of the Joukowski transformation 




(2.5-114) 


becomes infinite for £=0 and zero for £= + b. By choosing £j=b, the 
trailing edge becomes a stagnation point. This choice satisfies the Kutta- 
Joukowski condition, which requires the flow field in the neighborhood of 
the trailing edge to be finite even though there is a discontinuity in the 
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slope of the surface at the trailing edge. In the z-plane the trailing 
edge is mapped to the point 


x T = 2b. (2.5-115) 

Next, the leading edge must be located such that the remaining discontinu- 
ity is within the airfoil and thus will not cause a singularity in the flow 
field. 

Recall from Equation (2.5-111) that lines of constant ^ form ellipses 
in the z-plane. The radius of curvature along = constant is given by 

_ 2b (cosh^tf sin^0 + sinh^tf cos ^0)^ 

r ‘ sinhj* cosh,* (2.5-116) 

With the leading edge located at 6=r, the radius of curvature becomes 


r 


2b 


2 

sinh ^ 
cosh^ 


(2.5-117) 


Retaining the first terms of the Taylor series expansions for sinh^ and 
coshjf, the radius of curvature is approximately given by 


r = 2b/ (2.5-118) 

The location of the leading edge in the z-plane can be found by substitut- 
ing y=0 into Equation (2.5-111) and solving for x to yield 

x L = -2b cosh^ (2.5-119) 

Again using the Taylor series expansion for cosh^, Equation (2.5-119) 
becomes 


X L = -2b (1 + jp) 


(2.5-120) 
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or in terms of the radius of curvature the location of the leading edge is 
given by 


x 


L 



(2.5-121) 


Now the chord length of the airfoil section can be found from 


C = 



r 

4b + — 


(2.5-122) 


solving for b 


b = (c - tj-) / 4 

In the interpolation of the surface pressure and skin friction, the 
user specifies values of 6 from 0 to 2t, corresponding to starting at the 
trailing edge and traversing the upper surface to the leading edge and back 
along the lower surface to the trailing edge (Figure 2.5-17). 

Computationally, the first task in determining the values of x and y 
that correspond to a given 6 is to find the leading edge point and align 
the coordinates. The local coordinates are measured from the nose with the 
x-direction pointing through the trailing edge. Since now the local x and 
y coordinates are functions of the arc-length interpolation variable, s, 
then we can find the value of sin2$ a s a function of s by rearranging Equa- 
tion (2.5-113). 


sin 4 * * sin 2 * [y 2 ♦ y 2 - l] - y - 0 < 2 - 5 - 123 > 


Solving the quadratic for sin^fl 


sin 2 0 = - 


-T1 


+ J Tl 2 + y 2 /b 2 ] 


(2.5-124) 
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where 



We can set up a function FELLIP(S) 

FELLIP(S) = sin 2 0 (s) - sin 2 ^ 

where 0-j is the input value supplied by the user. The ZEROIN subroutine is 
used to find the root of this equation between specified bounds. Care must 
be exercised since each value of sin^- could have four possible roots 
corresponding to the four quadrants of the airfoil (upper/lower), leading/ 
trailing). Once the value of s has been determined, the remaining values 
corresponding to that point can be Interpolated (pressure, skin friction 
etc.) . 

2.5.4 Transonic Propeller Noise Module 

This module computes the periodic acoustic pressure signature and 
spectrum of a propeller with transonic tip speed. The computation is based 
on a solution of Ffowcs Williams-Hawkings equation (FW-H eq.) without the 
quadrupole source term (Refs. 2.5-1 through 2.5-3). The blade surface 
pressure is assumed to be steady and must be specified on a grid of points 
covering the blade surface. The observer is always assumed to be moving 
with the aircraft; only in such a frame is the acoustic pressure periodic. 
The solution to the FW-H equation is given by two different formulations 
which assume a source distribution on the full blade surface. The formula- 
tion which is suitable for blade sections moving at transonic speeds is 
used only when necessary. A list of symbols is provided below in order 
that the reader may follow the analysis. 

Symbols 

c Ambient speed of sound, m/s (ft/s) 

f Function defining the blade surface 
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< tc 


Frequency, Hz 


fk 

g 

k 

t 


in 

M 


Nb 


N S 

Nt 


P 

P' 


Pa 

Po 

PL 

P P 

PT 


Equation g = 0 describes relationship between source and observer 
time 

Harmonic number 

Local force per unit area of the blade acting on the fluid, Pa 
(1 bf /ft 2 ) 

Exponent; 2 m is the number of time points used by FFT routine 

Source Mach number 

Blade surface unit normal vector 

Number of blades 

Maximum harmonic number of interest 
Number of time points in time history 
Surface pressure (p = Pa " Po ) • 0 bf /ft 2 ) 

Acoustic pressure, Pa (1 bf /ft 2 ) 

Absolute surface pressure, Pa ( 1 bf / ft 2 ) 

Ambient pressure, Pa (1 bf / ft 2 ) 

Acoustic pressure produced by loading, Pa (1 bf / ft 2 ) 

Total acoustic pressure produced by propeller, Pa (lbf/ft 2 ) 
Acoustic pressure produced by thickness, Pa (lbf/ft 2 ) 
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P ref Reference pressure for definition of dB r 2 x 10“ 5 Pa 

r Vector from source point at emission time to observer, m (ft) 

(r - lx - y (r*) I) 

/\ 

r Unit vector in the direction of r 

SPL^ Acoustic spectrum, dB 

t Time at which noise signal is received by observer, s 

v Source velocity, m/s (ft/s) 

Vp Forward velocity of the aircraft, m/s (ft/s) 

x Observer position in the ground-fixed frame, m (ft) 

t Observer position in the aircraft-fixed frame, m (ft) 

y Source position in the ground-fixed frame, m (ft) 

? Source position in the aircraft-fixed frame, m (ft) 

rj Source position in the blade-fixed frame, m (ft) 

0 Q Change in root pitch angle, rad 

9 Angle between the radiation vector and the surface normal vector, 

rad 

fj, f 2 Elliptical surface coordinates 

p Q Ambient density, kg/m 3 (slug/ft 3 ) 

r Time at which noise signal is emitted at source position, s 
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r* Solution to the retarded time equation, g = 0, or a given observer 

time, s 

a Solution to retarded time equation as solved by Newton's method 

(f - Q(r - t)), s 

^ Angle between the x^ and axes, rad 

Superscripts 

Vector 

Mean 

A 

■* Unit vector 

• Time derivative 

* Complex conjugate; specific solution to retarded time equation 
Subscripts 

i Component along the l^h coordinate axis 

A 

(note: . r^ implies summation convention) 

n Component in the direction of the surface normal 

o Ambient condition 

r Component in the direction of the radiation vector 


01-168-86 


2-195 



2.5.4. 1 Acoustic Formulation 


The equation used to calculate the acoustic pressure time signature of 
a high speed propeller, derived in the subsonic propeller noise module, is 


4tp' (x,t) 


1 <L 

c 9t 


f'o 


p CV +1 
^o n r 

rji-Mr 


dS + 
r* 




(2.5-125) 


Equation (2.5-125) contains a potentially singular term, 1 1 -M r I , in 
the denominator. As long as each point on the blade moves subsonically in 
the direction of the observer, the solution behaves nicely. In this case, 
Equation (2.5-125) can be written in the following computationally effici- 
ent form: 


and 


4xp'(x,t) = -i / 

L c f=0 


! i r i 


r(l-M r )‘ 


dS 


+ / 

f=0 


n r - i-jM-j 


r 2 (l-M p ) 2 J 


dS 


+ c / 

C f=0 


l r (rfi^.+cM^cM 2 ) 


r 2 (1-M p ) 3 


dS, (2 . 5- 126a) 


4rp T (x,t) = / 
f=0 


Vn (r Vi + cM r " cM ^ 


r 2 (l-M r ) 3 


dS, (2 . 5- 126b) 


P' (x,t) = p^x.t) + pj(x,t) 


(2.5-126c) 
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where Pl and P-j- denote the loading and thickness noise, respectively. The 
symbols Mi, fy, li, and Ti are defined as follows: 


11 

c 

(2.5-127) 

• 

(2.5-128) 

c 

A 

P n i 

(2.5-129) 

• ~ * 
pn. + pn i 

(2.5-130) 


where 

n. = (5 x n). (2.5-131) 

When the radiation Mach number approaches or exceeds unity for a given 
point on the blade at a given time, then the following equation is used in 
place of Equation (2.5-126). 


4irp,(x,t) = ft / 

L 01 f=0 

g=0 


r sin0 


dfdr + 


I ~ 

f=0 r l 
g=0 


dfdr 


(2.5-132a) 


sin0 


I 

4irp T (x,t) 


a PrS- v „ 
3 , n 

3t J r sin0 


dfdr 


(2.5-132b) 


Pp(x,t) = P L (x,t) + P T (x,t) (2-5— 132c) 

where 6 is the angle between the blade normal, n, and the radiation vector, 
r. The symbol T is used to mean the locus of points on the blade that are 
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at a distance r from the observer at emission time r. In other words, r is 
the curve of intersection of the surfaces f = 0 and g * r - t + (r/c) = 0. 

The transonic propeller noise module uses both Equations (2.5-126) and 
(2.5-132) to calculate p'(x,t). Equation (2.5-126) is used whenever pos- 
sible because the computer Implementation is simple and efficient. A 
thorough discussion of these and other acoustic formulas for calculating 
propeller noise is contained in Reference 2.5-3. 

2. 5. 4. 2 Frames of Reference 

In this section the coordinate frames used in the acoustic 
calculations will be discussed. Basically there are two reference frames: 
the ground-fixed x-frame and the blade-fixed 7-frame. The x-frame, which 
remains fixed to the undisturbed medium, is set up as follows: 

• The origin of this frame is at the propeller center at time t = 0. 

• The propeller disk is in the xiX2~plane and the X£ axis coincides 
with the propeller axis, with positive direction in the flight 
direction. 

• The xj-axis is assumed to be orthogonal to X3, upward and parallel 
to the plane of symmetry of the aircraft. 

• The x?-axis is defined in such a way that the x-frame is right- 
handed. 

The observer position is always specified in this frame as will be 
explained shortly. 

The blade-fixed frame is set up as follows: 

• The origin coincides with the origin of the x-frame at t=0. 

• The 73-axis coincides with the X3~axis. 

• The 72-axis lies on the pitch change axis of the blade. 

• The 7172-plane is normal to the propeller shaft. 

• The nj-axis is defined to make the 7-frame right-handed. 

Note that the blade mean surface does not lie in the 7172-plane but makes 
an angle equal to the geometry pitch angle at each radial position. Note 
also that the 7-frame rotates with angular velocity fl. 
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In the acoustic formulas presented in the previous section, many 
operations Involving dot products or cross products of two vectors are 
required. When the products involve blade normals or surface pressures, it 
is convenient to transform the components of these vectors to the tj-frame 
and then perform the operation. However, note that the source position y 
always refers to a source point in x-frame with a known position tj in the 
blade-fixed frame. The quantities r = x-y and r = r/r are calculated in 
the x-frame, and then the vector components are calculated in the 17-frame. 
Note that for any variable which has a velocity term, such as M r = M-j r n * and 
v n = v*n, the velocity is with respect to the x-frame. In other words 


v - d -h 

V 1 3 r 


(2.5-133) 


The components of this vector must then be calculated in the 17-frame to get 
M r and v n . 

Another frame of reference which is used conceptually is the aircraft- 
fixed, nonrotating ^-frame. This frame coincides with the ground-fixed 
x-frame at t=0. The acoustic pressure p'(£,t) for an observer in the 
aircraft-fixed frame with the position vector $ is found as follows: Since 

both t and t are known, the relative position of the ground-fixed frame and 
the aircraft-fixed-frame is known. From this, calculate the observer 
position x in the ground-fixed frame. Using this x and t, calculate 
p'(x,t) which is the same as the acoustic pressure at position X in the 
aircraft-fixed frame and at time t. Thus, the t-frme itself is never used 
in acoustic calculations, even though the pressure signal which results is 

p'S.t). 

The transformation from one frame to the other at time t, can be writ- 
ten in matrix notation as 


X 
»— * 


cos^ -sin^ 0 


‘ *1 ' 

OJ 

X 

II 

sin^ cos^ 0 


V 2 

CO 

X 


0 0 1 


. V 3 . 


(2.5-134a) 
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( 2 . 5 - 134 b) 


X 1 


' X 1 ' 


’ 0 ‘ 

X 2 

= 

X 2 

+ 

0 

. X 3 . 


. X 3 . 


. V. 


where (*71 , 72, 73) is a point in the rotating 7-frame, (Xj, X2, X3) is the 
corresponding point in the moving 1 frame, (xj, X2, X3) is the correspond- 
ing point in the ground-fixed frame, and ^(=0t) is the angle between the X^ 
and 71 axes. 

A final coordinate transformation is necessary to account for changes 
in the root pitch setting. This rotation through a small angle, 9 q, is 
applied to the blade surface coordinates which are calculated by the blade 
shape module. 



cos0q 0 sin0 Q 


V\ ' (£1 ' £2^ 


0 1 0 




-sinflg 0 cos0q 


• ?2 ' (£1 1 £2^ ■ 


( 2 . 5 - 135 ) 


Whenever the 7-frame or pitch axis coordinate system is mentioned herein, 
it is assumed that the above correction transformation has occurred. Often 
the blade shape module and transonic propeller noise module will be execu- 
ted without change to the collective pitch setting. Thus, 0 g =o anc i the 
last transformation is unnecessary. 

2 . 5 . 4. 3 Computational Strategy 

Three elements that influence the computational strategy for noise 
prediction are numerical accuracy, computational efficiency and conceptual 
simplicity. The trade-offs are never straightforward but the simplest 
scheme which gives numerically stable answers in a reasonable amount of 
computer time is desired. A good balance is particularly crucial to the 
transonic propeller noise module. Moreover, it is important that the 
transonic and subsonic propeller noise methods give identical results for 
propellers with subsonic Mach numbers. These thoughts guide the computa- 
tional strategy. 


01 - 168-86 


2-200 



The first step In computing an acoustic pressure time history is to 
discretize one full revolution of the blade into even time Increments, t-j t 
and to represent the blade by a set of source points, ?(j). Even though 
the tip of the blade Is moving supersonically, some portion of the blade is 
subsonic. It will be helpful to define a subset of source points, ? s , that 
move subsonically. That is 





( n >? 7 ) 2 + V ? 


< l.o} 


(2.5-136) 


For each time point, the noise produced by the part of the blade 
represented by rj s can be calculated using Equation (2.5-126). The numeri- 
cal evaluation of Equation (2.5-126) is discussed in detail in the subsonic 
propeller noise module. The noise produced by the supersonic tip of the 
blade is calculated by either Equation (2.5-126) or Equation (2.5-132), 
depending on the value of M r for each source point. If M r exceeds some 
transitional value (usually 0.98) for any source point, then Equation (2.5- 
132) is used for the entire supersonic tip at that time. In practice, 
Equation (2.5-132) is used for less than one-fourth of the time points even 

in the worst case. 

Equation (2.5-132) is evaluated by dividing the blade tip into panels 
and by defining a set of possible emission times, {rj}. Each integral 
jj[]dTdr is approximated by applying a one-dimensional trapezoid rule as rj 
varies. The partial derivative with respect to source time, t, is approxi- 
mated by using a central difference formula after the integral over the 
supersonic tip has been calculated at times (ti + At) and (ti - At). 

The execution time required to compute Equation (2.5-132) is greatly 
influenced by the set of emission times, rj, that are chosen. If the span 
of all possible emission times is divided evenly, a very large number of 
times will be required. A better plan is to determine one, two, or three 
time intervals during which the T curve intersects the current panel. Each 
of these intervals can then be divided evenly. The time intervals them- 
selves can be determined by solving the retarded time equation at the four 
corners of the panel. This gives at least four and at most twelve times, 
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tj*, at which the r curve Is entering or leaving the panel. The time 
interval [rj*, tj+i*] will contribute to the integral over the current 
panel if the T curve is Inside the panel during that time. It Is suffici- 
ent to test the location of the curve at the median time, (rj* + rj + j*)/2. 
If the distance from the observer to the T curve is in the same range as 
the distance from the observer to each of the four corners of the panel 
then the time interval will contribute. 

There are several sources of error in this prediction method which the 
user must understand. The most important involves the geometric model of 
the blade. The blade position vectors, rj, and normal vectors, n, describe 
the blade shape very smoothly and accurately. Each panel of the supersonic 
tip is actually a curved surface. However, since the trapezoid rule is 
used to approximate the integrals and since linear interpolation is used to 
calculate the integrands at points along the edges of the panel, computa- 
tionally the curved panel is replaced by a flat plate. It is very impor- 
tant that the user supply grid which has a large number of nodes in those 
regions where the blade is highly curved. One good way to accomplish this 

is to use the same chordwise grid that was used for the blade shape module 

but add extra points near the leading edge. It may be necessary to add 
extra spanwise grid points as well. It is wise to have at least five 
spanwise grid points in the subsonic region and five in the supersonic tip. 
Finally, the user must take care to specify enough time points to accurate- 
ly represent the pressure time history. Unfortunately, the computation 
time will increase dramatically as the number of time points and grid 
points increases. 

2. 5. 4. 4 Retarded Time Equation 

As discussed in the subsonic propeller noise module, the retarded time 
equation can be written in the form 

f(^) = A^ 2 + B0 + C + cos(^+D) = 0 (2.5-137) 

where only the roots (0/Q) < 0 are of interest. Figure 2.5-18 is a typical 

graph of the retarded time equation that often results when the source 
points are moving at close to sonic speeds. It is not clear from the 


01-168-86 


2-202 




Figure 2.5-18. Graph of Typical Transonic Retarded Time Equation 
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figure whether this graph has one or more negative roots. In order to 
numerically solve for the roots using Newton's method, the number and 
approximate location of the roots must be determined. 

Notice that Equation (2.5-137) could be easily solved if the cosine 
term were absent. The first step in finding approximate roots is to set 
cos(0 + D) = -1 and solve for the negative root, 0g. The location of the 
actual roots must be in the interval [0g,O] because the cosine term cannot 
have a value smaller than -1. Next, approximate the cosine curve by a 
parabola which has the same minimum point and the same intercepts, and 
solve again. The resulting approximate retarded time equation may have 
one, two, or no real roots in the interval [^o » - If there is only one 
root to the approximate equation then it is a good initial guess at the one 
negative root to Equation (2.5-137). If there are no real roots to the 
approximate equation, then 0g will be a good initial guess to the one root 
of Equation (2.5-137). If, however, there are two roots to the approximate 
equation then the situation must be further clarified. 

Figure 2.5-19 is an exploded view of the graph in Figure 2.5-18. Note 
that there are three roots in this particular case. The best way to find 
them is to first find the local minimum and maximum points on the curve. 
That is, solve 


= 2A0 + B - sin(0+D) = 0 (2.5-138) 

Approximate solutions, and fa, to Equation (2.5-138) are adequate. If 
f(0l) and f (02) have opposite signs, there is a root of f between them. If 
it is determined that three roots exist, then (0g+0i)/2, (0j + 0 2 )/2 and 
02/2 will be very good initial guesses for use by Newton's method. 

2. 5. 4. 5 TPN Input 

The computation of transonic propeller noise requires definition of 
the blade shape characteristics, aerodynamic characteristics, flow and 
operating parameters, and observer coordinates. The noise signature is 
calculated using two different full blade formulations, depending on the 
radiation Mach number of the blade section. The input is consistent with 
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that for the subsonic propeller noise module and the two modules will give 
Identical results for subsonic cases. 


B 


Nb 

Ns 

M z 

to 

n 


Ci 

£2 

7l(£l. £ 2 ) 

*73 (£l . £2) 


* 1 . *2 


£l 

£2 
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User Parameters 

Blade length measured from axis to tip, m (ft) 
Number of blades 
Highest harmonic number desired 
Aircraft Mach number 
Change In root pitch angle, rad 
Initial azimuth angle of first blade, rad 
Angular velocity of blade, rad/s 
Blade Shape Table 

Spanwise location, normalized with respect to B 
Chordwise location, rad 

Blade surface abscissa, normalized with respect to B 

Blade surface ordinate, normalized with respect to B 

Slopes of basis functions at nodes 

Aerodynamic Characteristics Table 

Spanwise location, normalized with respect to B 

Chordwise location, rad 
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2. 5. 4. 6 TPN Program Validation 


The TPN program has been verified for near-field conditions by 
comparison with experimental data taken in the NASA-Lewis 8 x 6 wind 
tunnel for an eight-bladed SR-3 propeller. Pressure signatures and overall 
noise spectra at four different near-field stations (Figure 2.5-20) are 
shown in Figures 2.5-21 through 2.5-28 for an advance Mach number of 0.80, 
a helical tip Mach number of 1.14 and a power coefficient of 1.71, and an 
advance ratio of 3.06. Overall sound pressure levels calculated at the 
four stations are compared with data for Figure 2.5-29. The 11- and 
13-station blade description notations in Figures 2.5-21 through 2.5-28 
refer to the number of spanwise stations utilized to calculate blade 
loading, and the parameter a, defines the assumed camber-line loading 
distribution (see Figure 2.5-30). Note that the results for the pressure 
signature at Station No. 1 (Figure 2.5-21) does not show a single 
sinusoidal -type cyclic behavior over one period as noted at the other 
stations (Figures 2.5-23, 2.5-25, 2.5-27) and theoretically anticipated. 

This is due to difficulties with the iterative method utilized in TPN to 
solve the retarded time equation. Instances in which this method results 
in an incorrect solution are shown in Figures 2.5-31 and 2.5-32. Figure 
2.5-31 exhibits a situation wherein the initial guess for the solution was 
-3.40312 and the method picks the oscillating root at -7.8999 as the 
solution after the Iteration limit is reached, whereas the correct solution 
root is -6.40. Figure 2.5-32 depicts a case where, even though the initial 
guess for the solution was -3.7717, the method yields a final solution of 
+4.2245, whereas the graphical solution is shown to be -5.55. Clearly, 
refinement of the solution method is needed. Note, however, that even 
though the pressure signature is incorrectly predicted at Station 1, the 
first-harmonic sound-pressure level is within about 2% of the measured data 
(Figure 2.5-22). 

Difficulties in solving the retarded-time equation were not 
encountered at Stations 2, 3, and 4, and these results (Figures 2.5-23 
through 2.5-28) show well-behaved pressure signatures and good-to-excel lent 
agreement with noise-spectra data. 
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Figure 2.5-21. Acoustic Pressure Signature SR-3 Propeller Near Field 
M 0 = 0.80, J = 3.06, C D = 1.71, B = 8, M TH = 1.14 
xi, X 2 , x 3 = -1.219, 0.0254, 0.277 (Station No. 1) 

TPN code, a = 1.0 blade loading 
13 station blade description 
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HARMONIC NUMBER 

Figure 2.5-22. Overall Noise Spectra SR-3 Propeller Near Field 
M 0 = 0.8, J = 3.06, Cp = 1.71, B = 8, Mru = 1.14 
Transducer Station No. 1 
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Figure 2.5-23. Acoustic Pressure Signature SR-3 Propeller Near Field 
M 0 = 0.80, J = 3.06, C p = 1.71, B = 8, MjH = J- 14 
xi, X 2 , x 3 = -1.219, 0.102, -0.01 m (Station No. 1) 
TPN code, a = 1.0 blade loading 
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WIND TUNNEL DATA 

□ TPN, 13 STATION, a = 1.0 
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Figure 2.5-24. Overall Noise Spectra SR-3 Propeller Near Field 
M 0 = 0.80, J = 3.06, Cp = 1.71, B = 8, M TH = 1.14 
Transducer Station No. 2 
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Figure 2.5-27. Acoustic Pressure Signature SR-3 Propeller Near Field 
M 0 • 0.80, J = 3.06, C p = 1.71, B = 8 , M TH = 1.14 
xi, X 2 , X 3 = -1.219, 0.315, -1.044 m (Station No. 4) 
TPN code, a = 1.0 blade loading 
13 and 11 station blade descriptions 
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Figure 2.5-28. 


Overall Noise Spectra SR-3 Propeller Near Field 
M 0 = 0.80, J = 3.06, Cp = 1.71, B = 8, M TH = 1.14 
Transducer Station No. 4 
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Flqure 2.5-29. Overall Sound Pressure Level SR-3 Propeller Near Field 

M 0 = 0.80, B = 8, J = 3.06, C p = 1.71, n = 8495 rpm, M TH = 1.14 
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F ( X ) - AX 2 ♦ BX + C + COS (X+D) = O 

A = 0/87974 
B = 0.253942 
C = -2.492615 
D = -.3788825 


INITIAL GUESS = -3.40312 

FINAL SOLUTION BY TPN = NO SOLUTION AFTER 

20 ITERATIONS (-7.8999) 

GRAPH I C SOLUTION = -6.40 


- 10.0 


Figure 2.5-31. 




01 - 168-86 



In addition, the overall sound-pressure levels predicted by TPN 
(Figure 2.5-29) show good-to-falr agreement with data depending on station 
location, and are relatively Insensitive to blade-loading parameter. 

Errors of 1% - 2% may be noted at the first two stations downstream of the 
propeller plane (Stations 2 and 3, Figure 2.5-20), whereas errors on the 
order of 7% are noted at the upstream and far downstream station (Stations 
1 and 4, respectively). 
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2.6 STRUCTURAL BEAM MODULE 

The free vibration analysis of a generally curved and pretwisted ro- 
tating blade Is a complex problem that requires the development of a non- 
linear analytical model. For conventional blades, and advanced blades 
(advanced prop-fan, Figure 2.6-1), this model must be general enough to ac- 
count for an arbitrary amount of blade curvature and pretwist, as well as 
blade cross sections with general prismatic shape. Allowances must also be 
included to account for changes In the blade orientation at the hub. These 
changes, which will alter the centrifugal forces of the blade, include a 
pitch setting for conventional propellers and a general pitch setting about 
an arbitrary vector for advanced prop-fans (1 . e . , pitch setting is a linear 
combination of pitch, precone, and sweep). These blades which are quite 
flexible require a nonlinear theory for deriving the equations of motion in 
order to properly account for the stiffening effects from the centrifugal 
forces. 

Due to the complexities of this problem, an exact solution cannot be 
determined so approximate methods (for example, Rltz, Galerkin, finite 
element) must be used. The finite element method was chosen because it 
readily lends itself to the modeling of a curved and twisted blade. The 
other methods were unattractive because they either required knowing ap- 
proximate deflection functions (Ritz method) or required deriving the full 
nonlinear partial differential equations of motion and natural boundaries 
of the (Galerkin's method). 

The finite element method, which is based on variational principles, 
is applied by dividing the blade up into subregions, calculating the total 
dynamic potential (U - T - W e ) for each subregion, and then deriving the 
finite elements by taking the variation of each subregion (Hamilton's prin- 
ciple). In this development, each subregion is defined with straight beam 
type finite elements which are located along the curved line of shear cen- 
ters of the blade, Figure 2.6-2. The curved line of shear centers of the 
blade must first be calculated (for example, using the method in Section 
2.6.8) before this analysis can be done. The finite elements for each 
straight beam are derived with allowances for arbitrary cross section 
shape, beam pretwist, cross section warping (St. Venant type warping 


01-168-86 


2-222 



STAGE 

a) TURBOPROP STAGE AND PROPELLER 




Figure 2.6-1. Advanced Propeller (Prop-Fan) 
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functions) and nonlinear behavior based on the moderate deflection theory 
(small strains and finite rotations). All of the effects of blade rotation 
are properly Included by allowing the beam element to be arbitrarily 
positioned within the blade coordinate system (Figure 2.6-2). An ordering 
scheme Is developed to identify and neglect higher order terms which are 
produced during this development. 

A model for the free vibration analysis of a generally curved and 
pretwisted rotating blade Is developed by the following steps: (1) The 

curved blade is divided into a summation of straight beams which are laid 
end-to-end along the line of shear centers of the blade. (2) All of the 
transformations matrices associated with the blade and the straight beam 
element are derived. (3) The strain energy, kinetic energy, and work of 
external forces for a beam element are derived. (4) The finite elements 
associated with a single straight beam are derived by taking a variation of 
the total dynamic potential (Hamilton's principle). (5) The beam elements 
are assembled to form a structural model of the blade. (6) The free 
vibration analysis is calculated using the nonlinear finite element model 

List of Symbols 

Strain energy, kinetic energy, and external work 
boundary terms of the beam, Equations (2.6-54), 

(2.6-67), and (2.6-71) 

Young's Modulus 

Modulus weighted axial stiffness of the beam 
Modulus weighted first moments of the beam cross 
section, Equations (2.6-48c) and (2.6-48e) 

Cross section integrals of the beam, Equations 
(2.6-48g) through (2.6-48j) 


of the blade. 


b(U) ,b(T) ,b(W e ) = 


E 

EA 

EAj7a,EA£ A 


EAC 0 ,EAC lt EAC 2 ' 

EAC-, 
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EADQ.EADj.EADg”! = Modulus weighted warping constants of the beam cross 
EAD 3 * EAD 4 , EAD 5 section, Equations (2.6-49a) through (2.6-49k) 
EAD£,EADJ,EAD£ 

EADj , EAD^ 

EIwEI«.EI* = Modulus weighted bending stiffness of the beam about 

the curvilinear coordinate axes, ( 7 ,^), Equations 
(2.6-48b) , (2.6-48d) , and (2.6-48f) 


EA7 A ,EAf A , 

ead 1 ,ead 2 , 
e 1 w ,ei k ,e 1 v$ ' 


= Constants defined In Appendix A 


e x » e y r e z 


e x» e 7» e $- 


e’ ,e' ,e' 
x V $ 


e",e ' 
x 7 



{F^.CFCFj^pT} 

{Fl},{FCF} 

1 1 


= Undeformed element coordinate axes of the beam 
model, Figure 2.6-2 

= Curvilinear coordinate axes, which rotate with the 
beam pretwist, before deformation, Figure 2.6-6 
= Curvilinear coordinate axes of the beam, after 
deformation, Figure 2.6-8 

= Deformed curvilinear coordinate axes of the beam, 

(e'.e'.e 1 ), after a virtual motion 
x 7 £ 

= Base vectors on the deformed line of shear centers 
of the beam 

= Element force arrays of the beam model, Equations 
(2.6-87) through (2.6-89) 

= Element force subarrays of the beam model, Appendix 


A 


GJ = Torsional stiffness of the beam, Equation (2.6-48k) 

9 x» 97 i 9 £ = Base vectors of the undeformed beam 
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CD > 


x»Gj7*6£ 

hl.hj.hk 


hx.hy.hz 

hQ x ,hQ y ,hQ z 


= Base vectors of the deformed beam 
= Translational offsets, used to position the element 
axes (e x ,e y ,e z ) with the Inertial reference frame 
(1,j,k), Figure 2.6-2 

= Translational offsets in the element coordinate axes 
(e x ,e y ,e z ), Equation (2.6-59a) 

= Constants defined in Appendix A 
= Mass weighted second moments of the beam cross 
section, Equations (2.6-65b), (2.6-65d), and 


In V I V ,I V 

AAA 

U.k 

AAA 

io» Jo* 

AAA 

I.J.K 

[ J L ] . [ J NL 3 


(2.6-65f) 

= Constants defined In Appendix A 
= Blade coordinate system, Figure 2.6-4 
= Hub coordinate system, Figure 2.6-3 
= Inertial reference frame, Figure 2.6-3 
= Linear and nonlinear Jacobian matrices, Equations 


(2.6-85) and (2.6-86) 


[ KL],[ kNL] • 
[ K CF ] , [ K 1 ] - 
[ K T ] 

[ 4j].[ 

[ K i jl ■ [ 

r i/F t 


s Submatrices of the nonlinear Jacobian matrix, 
Appendix A 

= Element stiffness matrices of the beam model, 
Equations (2.6-82), (2.6-87), (2.6-88), and 
(2.6-89) 

= Element stiffness submatrices of the beam model, 
Appendix A 
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= Length of the beam 

■ Mass weighted area and first moments of the beam 
cross section, Equations (2.6-65a), (2.6-65c), and 
(2.6-65e) 

= Constants defined In Appendix A 
= Moment resultants 

= Element mass and Coriolis damping matrices of the 
beam model , Equation (2.6-87) 

= Element mass and Coriolis damping submatrices of the 
beam model, Appendix A 
= Beam distributed loads 
= Stress resultants of the beam 
= Beam distributed moments 

= Nodal deformation array of the beam. Equation 
(2.6-80) 

= Position vector of a point on the line of shear 
centers, before deformation 
= Position vector of a point on the rotating blade 
after deformation, Equation (2.6-56) 

= Position vector of a point on the beam, before 
deformation, Equation (2.6-6) and Figure 2.6-7 
= Position vector of a point on the beam, after 
deformation, Equation (2.6-10) and Figure 2.6-7 
= Displacement vector of any point on the beam, 

Equation (2.6-11) and Figure 2.6-7 
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0 R 
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x» 


S' 
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= Position vector of a point on the line of shear 
centers, after deformation 
= Moment resultants, Equations (2.6-47a) and 
(2.6-47b) 


t 

T 

Tx 

[T eb ] » 

[T D c3*t T DE^ 

u,v,w 

Uc» V C* W C 


U 

{u},{v}.{w} 

»* 

A 

V 

W e 

x,y,z 


= Time 

= Kinetic energy 
= Moment resultant of the beam 
* Transformation matrices used In the beam model 
development, Equations (2.6-1) through (2.6-4), 
(2.6-25), and (2.6-59b) 

= Displacement components 

= Components of displacement In the e x , and in- 
directions, respectively 
= Strain energy 

= Element deflection arrays, Equation (2.6-78) 

= Stress resultant of the beam 
= Velocity vector of a point on the rotating beam, 
Equation (2.6-56) 

= Work of the nonconservative forces 
= Element coordinates 

= Curvilinear coordinate system of the beam, Figure 
2.6-5 


*i.yi 


vvvv 

VW, 

V V 
v* w 


= Components of the element coordinate arrays 
= Notation used for writing the beam energy 
expressions in concise form, Equations (2.6-53a-d) 
and (2.6-64a-f) 
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Greek Symbols 


PM 

Pl'Pl'Pk 

Pp>Pc'Ps 


€ xx ,e riri ,e $$ 

e x£'%' e xi7 


K ip K $ 


K rjo • *£0 

n 


P 


a ,a ,a 
xx* yy zz 

a ,a ,a 

xx' W $$ 


To 

T 


T* 

r C* r C 


r xz» r yz» r xy 

* 


= Pretwist angle of the beam, Equation (2.6-4) 

= Euler angles, Equation (2.6-3) and Figure 2.6-2 
= Pitch, precone, and sweep settings of the blade, 
Equation (2.6-2) and Figure 2.6-4 
= Small parameter. Defined In Section 2. 6. 3. 3 
= Normal strain components 
= Shear strain components 

= Rotation components of the curvilinear axes, 
(e x ,e^,e^.), during deformation, Figure 2.6-8 and 
Equation (2.6-25) 

= Deformed curvatures of the beam, Equations 
(2.6-30a-b) 

= Initial curvatures of the beam, Equation (2.6-8) 

= Total potential energy of the system 
= Mass density 
= Normal stress components 

= Initial pretwist of the beam, Equation (2.6-8) 

= Deformed twist of the beam, Equation (2.6-30c) 

= Elastic twist of the beam (r‘ = r - r 0 ) 

= Second order elastic twist effects of the beam, 
Equations (2.6-28) and (2.6-59b) 

= Shear stress components 

= Elastic twist angle of the beam, Equation (2.6-27) 
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= Second order elastic twist effects of the beam, 


ft) 

W 


Equation (2.6-31d) 

= Array of beam element twist rotations, Equation 
(2.6-78) 


{♦cWM^qW} = Hermlte cubic and quadratic Interpolation polyno- 
mials for the beam element 

{♦’},{$'} = First derivative of the Hermlte cubic and quadratic 

c ' q 


interpolation polynomials, Appendix A 
= Sc cor, d derivative of the Hermlte cubic and quadratic 

c ' q 




Interpolation polynomials, Appendix A 
= Beam cross section warping function, Equation 


(2.6-36) 


u = Natural frequency of vibration 

q = Rotational speed 

Q X( Q y< Q z = Rotational speed defined in the element coordinate 

. A A A . 

( e x* e y» e z> 


Special Symbols 


(>.* 

<>.y 



() ,* 


d( ) 


3( ) 


C) 


( ) 



= Derivatives of the argument with respect to the 
coordinates x, y, z, 17, and £, 
respectively 
= Differential of ( ) 

= Variation of ( ) 

= Derivative with respect to time, t 
Higher order terms 
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{ } * Array 

[ ] = Matrix 

[ ]"* = Inverse of a matrix 

2.6.1 Basic Assumptions Used In the Analysis 

The following assumptions are used in the development of a beam finite 
element model capable of a nonlinear structural dynamic analysis of rota- 
ting blades. The geometry of the blade and the beam type finite element 
are presented in Figures 2.6-3 through 2.6-6. 

(1) The speed of rotation of the blade is constant. 

(2) The blade Is modeled by a series of straight beam finite elements 
which are located along the line of shear centers of the blade. 
The cross section for each beam finite element Is defined as the 
section perpendicular to the line of shear centers. 

(3) The shape of the blade cross section Is arbitrary (l.e. no simp- 
lifying assumptions based on symmetry are made). There are three 
distinct points on the cross section. 

(a) Shear center of the cross section. The beam finite element 
Is defined using the shear centers of two adjacent cross 
sections of the blade. All cross sectional properties of 
the beam are defined relative to this point. 

(b) Area center of the cross section. 

(c) Center of mass. 

(4) The beam element has an arbitrary amount of built In pretwist 
which Is defined about the line of shear centers. Pretwist Is 
defined as the change In the angular orientation of the principal 
axes of the cross section along the beam length. 

(5) The stresses within the cross section (ffyy,0zzi0yz) are equal to 
zero. The strains within the cross section (e y y, e Z z#7yz) are 
allowed to be nonzero, but small (negligible compared to 1). 

(6) The beam can bend In two mutually perpendicular directions normal 
to the line of shear centers of the beam, and can also twist 
about this line of shear centers. 

(7) The beam Is subject to undergo moderate deflections, which Im- 
plies small strains and finite rotations. 

(8) An ordering scheme, based on technical beam theory, is used to 
Identify and neglect higher order terms. 
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Figure 2.6-3. Inertial and Hub-Fixed Coordinate Systems 
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a) VIRGIN FORM— 14 NODAL DEGREES OF FREEDOM 



b) AFTER CONDENSATION— 12 NODAL DEGREES OF FREEDOM 

Figure 2.6-6. Beam-Type Finite Element 
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(9) A warping function Is used to model the axial deformation of the 
beam due to torsional twist. 

(10) The effects of damping (1.e. r structural or viscous) are not 
Included. 

2.6.2 Geometric Preliminaries 

The development of a nonlinear beam finite element model for the anal- 
ysis of a rotating, pretwisted blade undergoing moderate deflections 
requires the use of five coordinate vector sets. The coordinate vector 

' AAA 

sets are: the element coordinate system, (e x ,ey,e z ), the curvilinear 

coordinate system, (e x , e^,e^), a blade coordinate system, (i , j , k^,^a^hub 
coordinate system, (1 0 .j 0 .><o). and an inertial reference frame (I , J , K) . 

The beam finite element and the equations of motion are derived in the 

AAA 

element coordinate system, (e x ,ey,e z ). This coordinate system is an 
orthonormal vector set with one vector, e x , defined along the undeformed 
line of shear centers of the beam, and the other two vectors, e y and e z , 
defined in the cross section of the beam, Figure 2.6-5. The applied forces 
of the beam are defined in this system. 

AAA 

The curvilinear coordinate system, (e x ,ejj»e^) » is also associated with 
the undeformed beam and It Is used to account for the axial -bending-torsion 

a 

coupling effects of a pretwisted beam. The vector, e x , Is defined along 
the undeformed line of shear centers of the beam element. The two 
remaining vectors, e^ and e^, are defined in the beam cross section and 
they rotate about the line of shear centers, e x , with the pretwist of the 
beam. These two vectors remain parallel to the principal axes of the beam 
cross section at any point over the beam length, Figure 2.6-5. The strain 
components, the material properties, and the cross section warping function 
are all derived in this system. 

The blade coordinate system (i,j,k) rotates with the hub and it is 
used to define the coordinates and the displacements of the blade. The^ 
vector 1 aligns with the pitch axis of the blade and the vectors j and k 
are associated with In-plane and out-of-plane displacements of the blade, 
respectively. All three vectors are orthogonal to each other. The beam 
finite elements, which are defined In the element coordinate system, must 
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first be transformed to this coordinate system before they are assembled 
along the line of shear centers of the blade. 

The hub coordinate system (1 0 ,Jo»ko) fixed to the rotating hub, 

^ A 

where the k 0 axis aligns with the spin axis, 1 0 axis aligns with the pitch 
axis, and j 0 Is perpendicular to both axes and Is located In the spin 
plane. Changes In the pitch setting or precone of the blade are accom- 
plished by changing the orientation of the blade coordinate system with 
respect to the hub coordinate system. 

AAA 

The Inertial reference frame (I,J,K) Is fixed In space and it is used 

A 

to locate the rotating blade, where the K axis aligns with the spin axis of 
the hub. 

In this section, the transformations between the five coordinate vec- 
tor sets are defined. The Initial pretwist and curvatures of the undeform- 
ed beam are calculated and an ordering scheme Is defined. 

2.6.2. 1 Transformation Relations Between the Coordinate Systems 

The four transformation matrices that relate the five different coor- 
dinate systems are defined In this section. The first transformation, 

[ThiL is used to relate the hub coordinate system to the Inertial refer- 
ence frame. The second transformation, [TbhL relates the blade coordinate 
system to the hub coordinate system. The third transformation, [TebL 
relates the beam element coordinate system to the blade coordinate system. 
The fourth transformation, [Teg], relates the curvilinear coordinate system 
to the beam element coordinate system. 

The transformation matrix, [Thi], Is defined to relate the hub coor- 
dinate system to the Inertial reference frame and to locate the rotating 
blade in space. The K axis of the inertial reference frame and the k 0 axis 
of the hub are both aligned with the spin axis (Figure 2.6-3). 

The transformation [Thi] Is written as follows: 


ftol 


' A ' 

I 

A 

K J 

1 ■ [ t hi ] ' 

J 

K 
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where [ T HI ] Is expressed as 



cos(Qt) 

-sln(Qt) 

0 


sln(Qt) 0 
cos(Qt) 0 
0 1 . 


where f] Is the rotational speed of the blade and t Is time. 


The transformation matrix, [TbhL Is defined to relate the blade coor- 
dinate system to the hub coordinate system. This transformation Is used to 
account for changes in the orientation of the blade with respect to the hub 
due to pitch (/?p) , precone (Pc) • an£ i sweep (/J$) which may all be operator 
controlled (Figure 2.6-4). Pitch Is the rotation of the blade about the 
pitch axis, 1, precone Is the rotation of the blade out of the plane of 
rotation, and sweep Is rotation of the blade within the plane of rotation. 
For standard aviation propeller blades, only the pitch setting can be 
changed. For advanced prop-fan propellers, all three angles are Included. 


The transformation [Tbh] is written as follows: 


N 

T 


r A ' 

io 

1 

' = [ t bh ] 

Jo 

& 

* * 


k o J 


( 2 . 6 - 2 ) 


where [ % ] 


Is expressed as 



10 0 * 
0 cos/J p s1n/J p 
0 -sln/Jp cos; p . 


co$p c 

0 

-s1n/J c ’ 

0 

1 

0 

sin/? c 

0 

cos p c . 


cos/J $ sin/? s 0 ' 
-sin cos p s 0 
0 0 1 . 


where the angles /? p , p c , and p s are defined In Figure 2.6-4. 


The transformation matrix, [T eb] » i s defined to relate the coordinate 
axes of the beam finite element to the blade coordinate system. Three 
Euler angles (P\,Pj,Pk) are used to orientate the beam finite element in 
the blade coordinate system (Figure 2.6-2). This transformation matrix Is 
also used to transform the applied loads, which are defined in the blade 
coordinates, to the beam coordinates system. 
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Writing the transformation relation: 


■ [ t eb ] 

where [ T^g J is expressed as 


■ 1 

0 

0 

cos /?j 0 

-s1n/?j 

cos/? k sin p k 

0 ' 

T EB ] = 0 

cos/^. 

sin/?.j 

0 1 

0 

-s1n/? k cosy0 k 

0 

. 0 

-sin/?. 

cos p^ . 

. sin/?j 0 

COS /?j J 

0 0 

1 . 


where the Euler angles are defined in Figure 2.6-2. 

The transformation, [TceL is used to relate the element coordinate 
system and the curvilinear coordinate system of the beam. This transfor- 
mation relation Is defined using the pretwist angle, /?, of the beam. The 
pretwist angle, p, Is defined as the angle between the element axes of the 

A A 

cross section, (e y ,e z ), and the principal axes of the cross section at any 
location on the beam, Figure 2.6-5. It Is used to account for variations 
in the cross section properties (material or shape of the cross section) 
over the beam length. As the shape of the cross section or the material 
properties vary over the beam length, the orientation of the principal axes 
of the cross section will also vary along the beam length. 

The relation between the curvilinear coordinate system and the element 
coordinate system Is given by: 





where [ T CE ] Is expressed as 


(2.6-4). 


‘ 1 0 0 

[ T CE ] = 0 cos £ 

0 -sin/1 cos p . 
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The Inverse relations of Equations (2.6-1) through (2.6-4) are given by the 
transpose of the matrices, because all of the coordinate systems are 
orthonormal . 


^ A 1 

I 

A 

J 

A 

K 




T 

>> 

j 


^ A ' 

1 

/S 

T 

A 

e x 

A 

j 

A 

k 

* * 

II 

— 1 
m 
03 

. e z . 


f A ' 

lo 

T 

Jo 

' s [ T BH ] 

k o 



(2.6-5a) 


(2.6-5b) 


(2.6-5c) 




(2.6-5d) 


From Figure 2.6-5, a position vector, r p , from the origin of the 
element coordinate system to a point In the cross section of the undeformed 
beam can be defined In either of the two coordinate systems: 


r p = x e x + y e y + z e z = x e x + if e ? + f e ? 
Using relation 2.6-4: 


* 'i 

X 


► ' 
X 

V 

>S 4 

H 

1 

O 

m 

y 

z 

k 4 


( 2 . 6 - 6 ) 


(2.6-7) 


2. 6. 2. 2 Initial Curvatures and Twist of Beam 

The initial curvatures Ujjo^^o) and the Initial pretwist (r 0 ) of the 
undeformed beam, are calculated using the transformation given in Equation 
(2.6-4), along with the derivatives of the curvilinear coordinate axes. 
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These relations are defined In the theory of space curves (for example, 
Wempner, Ref. 2.6-1, p. 354, Eqs. 8.8-8.10) 


V * V ? x.x 


A A 

e • e 
x rj.x 


k = e • e = - e • e =0 

$0 $ x,x e x e £,x 


A A 


/A A 


r = e • e = - e • e - B 
£ » 7 ,x ij £,x ^,x 


( 2 . 6 - 8 ) 


2. 6. 2. 3 Ordering Scheme for a Long Slender Beam 

An ordering scheme Is defined which Is used to Identify and delete 
higher order terms which are produced during the derivation of the non- 
linear equations of motion for a straight rotating beam. This is accom- 
plished by assigning relative magnitudes to all terms, and then neglecting 
terms which are considered small In comparison to the largest terms. This 
approach is In agreement with the ordering scheme developed by other 
authors (Refs. 2.6-2 and 2.6-3). 

The guidelines, which are used for assigning the relative magnitudes, 
were determined by careful study of the geometry and the deflection pat- 
terns of tip loaded straight cantilever beams. They are valid for most 
Isotropic engineering materials (i.e., aluminum, steel, titanium, etc.) and 
most fiber- reinforced composite materials (i.e., orthotropic and 
anisotropic material behavior). The use of fiber- reinforced composite 
materials will alter the actual deflection patterns of the beam, but these 
patterns will not exceed the ordering scheme parameters for most 
engineering applications. 

The geometric ratio of the cross section to the length (y/L, z/L) is 
taken as 0.2 for a long, slender beam. Defining this ratio as e, (e = 
0.2), quantities of e 2 are neglected with respect to unity. The axial 
coordinate ratio of the beam Is taken as unity (x/L £ 1). The pretwist of 
the beam, p , is defined as a large angle 2 1). The large angle 
assumption for pretwist angle, p, will guarantee that all the axial - 
bending-torsion coupling effects are included in the derivation. 
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The maximum allowed axial deflection of a cantilever beam is deter- 
mined by applying an axial tip load that will produce a stress state equal 
to the material yield stress. The nondlmenslonal axial deflection (u/L) Is 
on the order of 0.001-0.008 for most engineering materials. 

The maximum torsional deflection that a tip-loaded cantilever beam can 
experience before yielding is calculated based on the octahedral shear 
stress theory. For a cantilever beam with an elliptical cross section, the 
maximum torsional deflection (^) will be on the order of 0. 1-0.2, (e) . 

The maximum planar deflections are determined by applying a tip moment 
such that the stresses In the beam are equal to the material yield stress. 
For typical engineering materials, the nondlmensional deflections (v/L, 
w/L) and slopes (v |X , w fX ) at the tip will be on the order of 0.06-0.15, 

(e). 

The warping deflection ratio ty/L 2 ) Is defined to be the same order as 
the axial deflection, u. This assumption agrees with the exact solutions 
developed by other authors (Refs. 2.6-4 through 2.6-8), when the cross 
section exhibits symmetry. Based on this work, the derivatives of the 
warping function are defined as e. 

A summary of the ordering parameter, e: 

Order 1 : 

x 

L 

P 

Order e : 

1 

L ' 

v 

L * 

* 


L ( ) 


(2.6-9a) 


a 

L 


w 

L 


L £ 
L ' L 


'Ll 


(2.6-9b) 


\x * w .x 
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2 

Order e : 


(2.6-9c) 


u 


L • 


u 


.x 


1 _ 

.2 


The ordering scheme Is applied by determining the relative magnitude 
of all terms of an energy expression. If the largest terms are of order 
(e 1 ), then all of the terms of order (el) are retained (first-order terms), 
all of the terms of order (e^ + l) are retained (second-order terms), and all 
of the terms of order (e^ +2 ) or higher are neglected (higher order terms). 
It is Important to apply this ordering scheme to energy-type expressions 
only because, If one equation Is ordered differently than another, 
unbalanced matrices are produced. 

2.6.3 Development of Strain Components 

A detailed development of the elastic strain components by either a 
linear or nonlinear approach can be found In many books which cover the 
theory of elasticity. In this development, the elastic strain components 
are derived using a full nonlinear moderate deflection theory based upon 
the work of Wempner (Ref. 2.6-1). They are derived In a curvilinear 

AAA 

coordinate system (e x ,e 7 ,e f ) so that the effects of beam pretwist are 
properly accounted for. 

2.6.3 . 1 Outline of the Calculation of the Deformations and Strains 

Defining a point on an undeformed body as P, a position vector, r p , 
can be defined from the origin to the undeformed point, P [Equation 
(2.6-6), Figure 2.6-7]. 

After deformation, the point P on the body moves to a point P'. This 

A 

point Is defined by the vector R, Figure 2.6-7. The vector R is a function 
of the initial coordinates (x , * 7 , ^-) and the time, t. 

A A 

R - R(x, 7 ,£,t) (2.6-10) 

a 

The actual displacement, Rg, of the point P due to the deformation can 
be defined as the difference in the vectors R (Equation (2.6-10)) and r p 
(Equation (2.6-6)), Figure 2.6-7. 
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RD * R - r p (2.6-11) 

The curvilinear strain components are defined In Wempner (Ref. 2.6-1, p. 
355, Eq. 8.14) as follows: 


. G • G 

1 , x x 

2 A A 

g • q 
a x y x 




"X17 ■ 2 


G • G - g • a 
x n a x y r 

A A 

9x * 9x 


= H h m h ’ 1 }( 2 * 6 - 12c ' d ) 


: X$- “ 2 


G • G - q • a 
x <r 

A A 

9x * 9x 


VHV'f) (2.6-12e,f) 


where the base vectors of a point, P, In the undeformed body are defined 


9x ~ r p,x • 


Q V = * 


= r p.£ 


(2.6-13) 


and the base vectors of a point, P * , In the deformed body are defined as: 


G x = R ,x ' 


G„ = R „ . 

V 


■ R . f 


(2.6-14) 


2. 6. 3. 2 Undeformed Base Vector Development 

The calculation of the undeformed base vectors (gx»9j;»g^) for any 
point on the undeformed beam are calculated by taking the derivatives of a 
position vector r p , with respect to the curvilinear coordinates (Equation 

2.6- 13). This position vector Is written from the origin of the beam 
coordinate axes to an arbitrary point, P, on the undeformed beam (Equation 

2 . 6 - 6 ). 

Substituting the position vector Into the definition of the undeformed 
base vectors and taking the appropriate derivatives: 


g = r = e 
a x p,x x 


q V ~ r P»7 * ' 


v r P (2 * 6 - 15) 
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The position vector of a point on the line of shear centers before deform- 
ation Is (17 = £ = 0 ) : 

0 r * r p (x, 0 , 0 ,t) = x e x (2.6-16) 


2. 6 . 3. 3 Deformed Base Vector Development 

AAA 

The deformed base vectors (G X ,G^,G^) are calculated by taking the 
derivatives of a position vector, R (Figure 2.6-7), to a point on the 
deformed beam, P ' , with respect to the curvilinear coordinates (Equation 

A 

2.6-12)). The derivation of the vector R requires the Introduction of two 
assumptions on the deformation of the beam. The first assumption is used 
to define the motion of a point on the line of shear centers during 
deformation (Section 2. 6 . 3. 2.1). The second assumption Is an approximation 
of the strains within the cross section (Section 2. 6 . 3. 2. 2). 

The position vector for an arbitrary point P* on the beam after 
deformation at time t, is: 


R - R(x,J 7 ,£,t) 

it can also be written, using Equation (2.6-11), as: 


(2.6-17) 


R 


r p (x,> 7 ,£,t) + RD(x,i 7 ,f,t) 


(2.6-18) 


The deformed base vectors for any point on the deformed beam are calculated 
using the definition of the deformed base vectors from Equation (2.6-13). 


A 






A 







A 




A 






A 




(2.6-19) 


The position vector for a point P on the line of shear centers, after 
deformation (tj = $ = 0 ) Is: 


0 R = R(x, 0 , 0 ,t) 


( 2 . 6 - 20 ) 
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The deformation vector (Rq) of a point on the line of shear centers Is 
defined as: 


RD(x,0,0,t) = u c e x + v c e v + w c eg. (2.6-21) 

The position vector describing the line of shear centers after deformation 
Is obtained by substituting Equations (2.6-16), (2.6-20), and (2.6-21) into 
Equation (2.6-18): 


0 R = (x + u c ) e x + v c e^ + w c eg- (2.6-22) 

The deformed base vectors are calculated for points which lie on along the 
deformed line of shear centers (7 = £ = 0), by making use of Equations 
(2.6-19) and (2.6-21): 


E x = (1 + u c,x> 5 x + < v c,x - w c P.J *n + ("c.x + v c />,x> V 


E , ■ S , + VV 0 ' 0 ’ 1 ’,, 


(2.6-23) 


= + R 0( x o »°»O»t) ^ 


The motion which carries the curvilinear lines of the undeformed beam 
Into the curved lines of the deformed beam, carries the Initial undeformed 

AAA 

base vectors (gxf9fj.gc) °f a point P, to the deformed base vector set 
(GxjGn.G^). This motion can be looked upon as two successive motions. 
First, the undeformed base vector set (gx.g^«g^) Is rigidly transformed and 
rotated to the orientation of a deformed curvilinear orthonormal vector set 

AAA 

(e^e-.e,-) . Secondly, the deformed curvilinear vector set Is deformed to 

' ^ AAA 

the deformed base vector set (G x , G^ , Gg.) , which means changing the angles of 
the vectors as well as the lengths. An assumption, which Is based on the 
magnitude of the strains within the cross section ( £ riri> £ $$' £ r]$) < I s needed 
In order to complete the second step. 

AAA 

2. 6. 3. 3.1 Deformed Curvilinear Vector Set (e y ,e^ .eg.) 

AAA 

Consider an undeformed base vector set (g x »9iyig^) located on the unde- 
formed line of shear centers of the beam before deformation. During 
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deformation of the line of shear centers of the beam, this vector set is 

AAA 

carried to a deformed curvilinear vector set (e x ,e^,e^) through rigid body 
translation and rigid body rotation. Without any loss of generality, 
assume that e x is carried to the direction E x (l.e, tangent to the deformed 
line of shear centers). At this point, no assumption Is made about the 

A A 

orientation of the remaining vectors (e^,e^) with respect to the vectors 
(E ^,£$0. The transformation Is Illustrated In Figure 2.6-8. 


A 




(1 


u ) e + 
c,x' x 


(v - w r )e + 
v c,x c o' 1 } 


(w + v r )e 
v c,x c o' £ 


(2.6-24) 


If the rotation of the undeformed vector set to the deformed curvilinear 
vector set Is finite (l.e., not Infinitesimal), it has to be described by 
Euler angles. The sequence of rotations for the transformation Is 9g, 9 y, 
and 0 X and Is in agreement with the work of previous authors (Refs. 2.6-2, 
2.6-3, and 2.6-9). It should be noted that other sequences are possible 
and the form of the final set of equations Is dependent on this sequence. 
This motion is described In Figure 2.6-8. 


% 

~ 1 





®x 

1 S J 

1 = [ t dc ] 

* - 


where [ T QC j Is expressed as 


(2.6-25) 



1 0 O ' 

0 cos$ x s1n$ x 

0 -s1n0 cos0 . 

A A 
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slnfl 

V 
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-slnfl 
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COS0£ 

sind 

0 ' 

-sinfl^ 

s 

COS0„ 

0 
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0 

0 

1 . 


The Inverse of this transformation relation Is given by the transpose of 
the matrix because both vector sets are orthonormal. 


Consider the deformation of an element, dx, on the line of shear cen- 
ters of the beam, as described In Figure 2.6-8. The deformation procedure 
is as follows: First the element is carried in a rigid body translational 
that does not appear in Figure 2.6-8. Then, the element is stretched an 
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«> 



Figure 2.6-8. Curvilinear Coordinate System Arter Deformation and 
Euler Angles 
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amount u CfX dx. Next, the element Is rotated by 9^, about e^, so that the 
tip of the element moves a distance (v C(X - w c r 0 ) dx. Next, the element 
Is rotated an amount -9^, so that the tip of the element moves a distance 
(w c , x + v c r 0 ) dx. Finally, the element is rotated an amount 9 X about Its 
axial coordinate. 

The following trigonometric relations can be obtained from Figure 

2 . 6 - 8 . 


1 + u 


cos 9 


c .x 


, + u c,x> 2 * < v c,x - w c T o>' 


(2.6-26a) 


sin 9. 


v - w r 

C.X C 0 


(* + -c.x) 2 + < v c,x - "c T o> 2 


(2.6-26b) 


cos 8_ = 

V 


. <1 * -c.x) 2 * < v c.x - w c T o )2 


. d * -c.x) 2 + < v c,x - w c T o> 2 + < w c,x + v c T o> : 


(2.6-26C) 


sin 0 = 

V 


. + V C T o> 


c a x 


(1 + u cx ) 2 + (v cx - w c rf + (w cx + v c rf 


(2 . 6— 26d) 


The above expressions can be simplified using the ordering scheme described 
In Section 2. 6. 2. 3. The torsion twist angle, 0 X , Is replaced by In 


order to be consistent with 

the literature 

(Ref. 2.6-4). 



cos 9 - 

1 , 

sin 0 - 

v c,x “ w c r o 

* 


cos 8_ - 

V 

1 , 

sin 0 2- 

V 

< w c,x + v c r o> 


• (2.6-27) 

cos 9 X - 

1 , 

sin 0 X 2 

II 

X 

* 
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These six trigonometric relations are substituted Into the Euler angle 
transformation relation (Equation (2.6-26)) to produce the following 
transformation. 


[ t dc ] ’ 


< v c,x - w c T o> < w c.x + v c T o> 


- (v c,x - w c r o> - * < w c,x +v c r o> 1 

- (w c,x tv c T o> + * < v c,x - w c T o> -* - T c 


* 

1 


(2.6-28) 


where, 


7 \ * (V - W. T ) (w. v + V_ T ) 

c ' c , x c o c,x c o 


The inverse of this transformation matrix Is equal to the transpose, within 
the confines of the ordering scheme, Section 2. 6. 2. 3. 


The derivatives of the deformed curvilinear vector set (e Xl e^,e^.) with 
respect to the axial coordinate of the beam, x, are calculated using the 
transformation relation provided in Equation (2.6-25) and Equation 
(2.6-28). 



+ 




+ 


[ (v c,x - w c T o>,x - T o < w c,x * v c T o> ] S , 
[ ( W C,X + v c r o> ,x + T o ^ v c,x " w c T o> ] *£ 

[ ‘ (v c,x - w c T o> - * t"c.x + v c T o> ],x *x 

[ * T o ] S , + [ #,x + T o ] 

[ -(w +vr)+rf(v -wr) e 
v c,x c o' f v c,x c o' J,X X 

[ + T c>,x - T o ] + [ - T o W + T c ) ] 


(2.6-29a) 


(2.6-29b) 


(2.6-29C) 
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The deformed curvatures (x^,/^) and the deformed twist (r) of the line 
of shear centers of the beam are defined In the theory of space curves (for 
example, Wempner, Ref. 2.6-1, p. 357, Eq. 8-19). 


K 


V 


e' 





(2.6-30a) 


X 


$ 





(2.6-305) 


r 



• e 1 

TI.X 



(2.6-30c) 


The deformed curvatures and the deformed twist of the line of shear centers 
are calculated by taking the dot product of the deformed curvilinear vector 
set (Equations 2.6-25 and 2.6-28) with the derivatives of the deformed 
curvilinear vector set (Equations 2.6-29a-c). Using the ordering scheme, 
neglecting higher order terms, and substituting In for the element 
deformations (u,v,w): 



«, ■ V ,xx cos ^ + + w ,xx s1 "W + 

(2.6-31a) 


= -V xx sin (/I + ^) + w^ xx cos(/J + 4>) 

(2.6-31b) 


II 

o'* 

+ 

X 

+ 

o 

(2.6-31C) 

where 



*o - 

{w cos(0 + t) - v x s1n(/J + ^)}{v |XX cos(/J + *) + w xx s1n(/J 

+ ^)] 


(2.6-31d) 


and the small angle assumption Is used for 0: 

cos (/J + 0) = cos/J - l sin p 
sin (/} + <p) - sin p + f cos/J 


(2.6-31e) 
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From Equations (2.6-31a) through (2.6-31c) and the orthonormal Ity 

AAA 

conditions for (e x ,e^,e£-), It can be shown that: 


e x,x 


* e ' + 

v n 


r p 1 

f £ 




/V 

e 


x 


+ 





A 



Te v 


(2.6-32) 


Up to this point, the only assumption that has been made about the 

AAA 

orientation of the deformed curvilinear vector set (e^e-.e^) with respect 

• Ja a a 

to the base vectors for the deformed line of shear centers (Ex.E^.E^), is 
that e x Is parallel to E x (Equation 2.6-23). This assumption has also been 

A A 

made In previous developments (Ref. 2.6-2 and 2.6-3). The axes e^ and e^ 
will have a slightly different orientation then E ^ and E^- due to the 
presence of strain within the cross section. The vectors, e^ and e^, can 
be expressed In terms of E^ and E^ using the definitions presented in 
Wempner (Ref. 2.6-1, p. 356, Equation 8.16): 

e' • i = 1 + e (2.6-33a) 

V V W 

9 ' • E = 1 + (2.6-33b) 

^ • s ■ 1 + v (2 - 6 - 33c) 

For beams, composed of Isotropic materials, the Bernoul 11 -Euler 
hypothesis Is used (Ref. 2.6-3, 2.6-7, and 2.6-8) to relate the deformed 

AAA 

curvilinear vector set (ex.ejj.e^) to the base vectors of the deformed line 

AAA > J 

of shear centers (E X ,E^,E^). This hypothesis states: 
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"During bending, plane cross sections which are normal 
to the elastic axis (line of shear centers) before 
deformation remain plane after deformation, and normal 
to the deformed elastic axis (line of shear centers)." 


This hypothesis Is combined with the Implicitly stated assumption that 
strains within the cross section are equal to zero. 


e 


W 



(2.6-34) 


Combining Equation (2.6-34) with Equations (2.6-33a-c) will yield that the 

AAA 

deformed curvilinear vector set (ex» e J7» e £) parallel to the base 

vectors of the deformed line of shear centers (E x ,E,j,E^): 



2. 6. 3. 3. 2 Deformation Approximation 

The approximation for the deformation of a beam can be written by 
combining the solutions for simple extension, flexure, and torsion. A 
modification Is required to accommodate the warping of the cross section 
which Is produced from the bending and/or torsion of the composite beam. 

The vector R, which Is a position vector of a point In the cross section of 
the beam after deformation, consists of the sum of the deformation of a 
point on the line of shear centers combined with the warping of the cross 
section due to torsion twist of the beam and the rigid rotation of the 
cross section. 

R = Q R + i r' E x + rj E^ + f E ? (2.6-36) 

The axial deformation due to elastic torsional twist of the beam Is 
analyzed using the product of a warping type function, f, and the elastic 
twist, r', of the beam at the cross section location. This approach was 
first used for the torsional analysis of straight, untwisted, Isotropic 
rods. It has been shown that the warping function will have antisymmetric 
properties for doubly symmetric cross sections (Refs. 2.6-1, 2.6-5, 2.6-6 
and 2.6-10). This same approach is also used for the analysis of the axial 
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deformation of straight, pretwisted, Isotropic rods (Refs. 2.6-11 through 
2.6-18), where the assumption Is made that the warping function Is an 
antisymmetric type function that Is only dependent on the cross section 
variables and not on the pretwist. 

In this study, a general warping function Is used to model the axial 
deformation due to elastic torsional twist. It Is assumed that the func- 
tion is dependent on all three coordinates (x, tj ,$) for a general pretwisted 
beam, but will only be dependent on the cross section coordinates ( 17 , $•) for 
a uniform pretwisted beam ( 1 . e . , a beam that has a constant cross section 
along the beam length, but the pretwist varies along the length). No 
assumption regarding the form of the function Is made (for example, anti- 
symmetric function). The order of magnitude of the axial deformation due 
to elastic twist, Is assumed to be no larger than the allowed axial 
deformation due to axial loads (from Section 2. 6 . 2. 3, o(e 2 )). 

Substituting Equations (2.6-22) and (2.6-35) Into Equations (2.6-36), 
yields: 


^ r } 

r 

X 
<a> < 

r ^ 

f \ 

A 

e ; 

A 

R ■ (x + u c , v c , wj. 

!» 

* * 

+ ri, f)< 

!? 

* - 


Substituting Equation (2.6-24) Into Equation (2.6-36): 

R • {{x ♦ u c , v c , w c } ♦ {!» T\ f}[ T dc ]} 


(2.6-37) 


(2.6-38) 


AAA 


The deformed base vectors (G X , 6 ^,G^) are calculated using Equations 
(2.6-14), (2.6-32) and (2.6-37): 
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®x ■ 5 .x * < 3 + u c.x> *x + t(# r‘) iX - 7 - S *jl 

+ < v c,x - » c s * «* t '> *, - f t '> s ; ' < 2 - 6 - 39a > 

+ < w c,x + u c r o> « f + tW ’") * f + 7 r') S j . 

% • ■ <»., + (2 - 6 - 39b) 

S * R * (# , t') e' ♦ %• (2.6-39C) 

S »s »s * s 

2. 6. 3. 4 Strain Components 

The strain components (Equations 2.6-12a-f) are calculated using the 

A A A 

undeformed base vectors (gx.gn.g^) from Equation (2.6-15), along with 
deformed base vectors (G X ,G^,G^) from Equations (2.6-39a-c). They are 
expressed In the curvilinear coordinate system (e x ,e^,e^) In terms of the 
element displacements (u,v,w). The ordering scheme Is used to neglect 
higher order terms which are generated during the formation of the strain 
components. 

e xx • u .x * (» * ft ( *.x> 2 

+ I (v x ) 2 ■ v xx tv cos(/J + ^) - £ Sin (p + ^)} ’ (2.6-40a) 

+ \ ~ w ,xx c °s(P + f) + V sin {p + 0)} 

e x, ■ i - *) W.X + "o> < 2 - 6 - 40b > 

« xff ■ \ W if + 7) (# >x + # 0 ) (2- 6— 40c) 
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0 


(2 . 6-40d— f ) 



where ^0 represents a second-order effect that couples elastic torsion 
twist with the beam bending (Equation 2.6-31d). 

These six strain components can be directly compared with the strain 
components derived by Hodges and Dowell (Ref. 2.6-2), In their development 
of the nonlinear equations of a twisted rotor blade. The strain components 
agree with those calculated by Hodges and Dowell except for three terms. 

The first term, ^ 0 , Is the second order effects In the shear strains, 
e xr j and e x $ that appears In this model. This term, Equation (2.6-31d), 
represents the bending-torsion coupling of the pretwisted beam. 

A second term, (jj 2 + f 2 ) ^ (X P,*i representing additional axial strain 
due to beam pretwist Is not present In this derivation and was shown to be 
incorrect by other authors (Ref. 2.6-3, 2.6-11 through 2.6-17, and 2.6-19). 
This term, which Is used to model the axial -torsi on coupling effects due to 
pretwist, is Inappropriate because It does not reduce to zero for the 
simple case of a uniform beam with a circular cross section. 

A third term Is the axial strain due to cross section warping. In 
this development the term has the form, (^ 0 |X ) |X , while In development of 
Hodges and Dowell the term has the form, f ^ tXX . For pretwisted beams with 
a uniform cross section, the warping function Is only a function of the 
cross section coordinates, rj and £, so the chain rule must be applied to 
calculate the derivative. 


' ** ^,XX + { 1,1 *,x + S’.x ) *,x 

■ * t.xx + 1 } T o *,x < 2 - 6 - 4 

This term has been shown to represent the correct model for the axial de- 
formation and the decrease In torsional stiffness of a pretwisted uniform 
beam subjected to axial loads (Refs. 2.6-11 through 2.6-13, 2.6-16, and 
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2.6-18). Furthermore, It will reduce to zero for a uniform beam with a 
circular cross section. 

2.6.4 Derivation of the Equations of Motion by Hamilton's Principle 

The equations of motion and boundary conditions are derived for a beam 
rotating about an arbitrary axis using Hamilton's principle. These equa- 
tions are valid for a slender beam which Is composed of a homogenous mate- 
rial. The beam Is defined so that It can be arbitrarily offset and 
oriented with respect to the spin axis. This representation Includes 
lengthwise variation in the following properties: beam pretwist, mass and 

stiffness properties, and mass centroid offset and area centroid offset 
from the line of shear centers. The external loads are represented by a 
set of generalized distributed loads and moments, which are defined In 

AAA 

the element coordinates axes (e x ,ey,e z ). 

The strain energy, U, Is obtained using the strain components and the 
constitutive relations defined In the curvilinear coordinate system 
(e x ,e 7 ,e^). The curvilinear coordinate system is chosen because, for most 
applications where the beam has a uniform cross section with varying pre- 
twist, the cross section properties need only be defined once. If the 
element coordinate system was chosen, the cross section properties would 
need to be specified at each node location. 

The kinetic energy, T, Is developed by calculating the velocity vector 
of a point on the deformed beam and using the mass distribution of the 
cross section. The velocity vector Is calculated by taking the time deriv- 
ative of a position vector from the origin of the Inertial reference to a 
point In the cross section on the deformed rotating beam. This position 
vector Is capable of modeling a beam with an arbitrary offset and orienta- 
tion from the Inertial reference frame. 

The work of external forces, W e , Is derived by Including the effects 
of the nonconservative forces (i.e., distributed loads and moments) acting 
through a displacement about the deformed equilibrium position. 

Hamilton's principle represents a generalization of the principle of 
minimum potential energy to include dynamic effects. It is stated as an 
integral equation in which the total dynamic potential (U - T - W e ) is an 
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extremum over the time Integral; ti i t i t2* A discussion of the prin- 
ciple can be found In Refs. 2.6-20 and 2.6-21. Hamilton's principle can be 
stated In the following mathematical form; 



0T - 5W e ) dt = 0 


(2.6-42) 


2.6.4. 1 Strain Energy Contributions 

The total strain energy over the entire volume of a structure is writ- 
ten in terms of the curvilinear stresses and strains. 


U 2 jg JJ/'xx € xx + a x£ ?X£ + a xij 


(2.6-43) 


+ Sv + e <r? + a K % J d ’' dsr dx 


where 


'xrj 


= 2 e 


XTI 


7 x<T S 2 £ x? 


'VS 


2 e 


VS 


The variation of the strain energy, 6U, is calculated using the as- 
sumption that the stresses within the cross section are equal to zero ( a ^ 
= agg - a jig = 0) and by substituting the elastic Isotropic stress-strain 
relations into Equation (2.6-43): 


6U 


r L rr 

V^A 


6e 

67 

* 7 


xx 


x£ 

xiy 


E 

0 

0 


0 

G 

0 



df 6rj dx 


(2.6-44) 


where the strains have been defined In Equations (2.6-32a-f) and the 
variations of the strain components can be written as: 
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ffe Y¥ * ffu + v ffv + w ffw + 5(f f ) 

AA f a |A | A |A |A f A p A 

■ (ffv ,xx + w ,xx W* C0S (P + *) - S’ s1n(/J + *)} 
" ( 5w ,xx ■ v ,xx cos ^ + #) + V sin ^ + #)} 

* (T 2 * S 2 ) *. x f^x 


«7 X , * + e *o> 

(2.6-45b) 

*7x f = ( *,f + »>W,x + S *o> 

(2.6-45c) 


where 

= { 5w x co$ (/> + -<5v^ x sin(^ + 0)}{ V |XX COS (/* + 0) + w |XX sin ^ + #)} 

+{w x cos(/J + 0) - v ^ x s1n(/? + 0)}{s v |XX cos (/* + 0) +5w |XX sin 0 J + 

(2.6-45d) 

Since, the strain components are of order e 2 and e 3 based on an order- 
ing scheme, the variation In the strain components are also defined as 
order e 2 and c 3 . Expanding the strain energy (Equation 2.6-44) will yield 
terms of order e 4 , e 5 , and e 6 . Consistent with the assumptions of the 
ordering scheme, terms of order e® are neglected compared to terms of order 
e 4 . Once the triple product Is carried out, the Integration Is performed 
over the cross section. 

The variation of the strain energy, <5U, Is written In terms of stress 
and moment resultants: 
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+ (M z cos (p + + M y si n (/? + ^))(tfV jXX + W |XX <ty) 

+ (M z s1n(£ + - M y cos (p + ^))(^W fXX - v >xx ty) 

+ ^ + V !dJ s t* * 5 X S *o ** 


(2.6-46) 


The definition of the stress resultants Is described below. 

Terms which are double or triple underlined should be dropped when 
using the ordering scheme In a strict manner, (order e®, e?), however, 
these terms are retained because they represent important axial -torsion 
coupling effects for pretwisted beams (Ref. 2.6-11 and 2.6-13). 

- JJ/ e xx *1 <* < 2 - 6 - 47a > 

- EA { «.x * \ <\x> 2 + \ (w.x) 2 } + ™0 #.xx * ™0 #.* 

- <\ xx cos {p + 0) + W fXX si n (/? + ^)) 

- EA^ a (W |XX cos (f) + f) - v^ xx s1n(/J + ^)) + | EAC q (^ x ) 2 


? x ■ JJ/ E £ xx *1 <* < 2 - 6 - 47b > 

* “Oo (vl ( v ,x> 2 + 5 <",x> 2 } + »°3 «*.xx 
- EADj (v xx cos(; + f) + WfXX si n (/? + *)) + EADg x 
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(2.6-47C) 


- EAD 2 (w xx cos (p + fl - v^ xx s1n(/J + 0) + \ EAD 4 (^. x ) 2 

* JJ/.X E e xx <* 

■ »#A { « fX ♦ I (v,/ ♦ | C./ } ♦ »P 5 ^ xx 

- EADj ( v xx cos (y? + 0 + w xx s1n(/J + 0) + EAD 3 # tX 

- EAD£ (W fXX cos {fi + f) - v xx s1n(/? + f)) + f EAD^ (1 >X ) 2 

!x ' JJ A ^ 2 + S 2) E e xx d ’ d ? 

■ ttC, ( u .x *1 <».x> 2 *_j (".x) 2 ) * «°4 *.xx 

- EAC 1 (v xx cos(/? + Q + W xx s1n(/? + Q) + EAD^ 1 >X 

- EAC 2 (w xx cos(/7 + Q - v xx s1n(/? + Q) + ^ EAC 3 x ) 2 

fi y -JJ ? E £ xx d ’ d f 

* «f A { u iX ♦ \ (v iX ) 2 * \ (w tX ) 2 } ♦ ead 2 #i „ ♦ ead^ #i 

- EI^ (v xx cos(/J + 0 + w^ xx sin(/J + <p)) 


(2.6-47d) 


(2.6-47e) 
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- EI „ <\xx C0S W + *) - *,xx s1n (/> + *» * 2 EAC 2 ^.x) 2 


M z - |j -IJ E £ xx dl , df (2.6-47f) 

A 

■ - ea ’a { u ,x + 5 (v,x) 2 + I <",x> 2 } - EAD 1 '.xx - EAD i *,x 
+ EI^. (v xx cos {p + ^) + W jXX si n (/? + ^)) 

+ EI , f (w ,xx C0, W * (0 - *,xx s1n ^ + - g EAC 1 (*./ 

I 

The torque resultants, S and S , are used to couple the first- and 

A A m 

second-order elastic twist effects. S Includes terms of order e J and e 4 

^ l 

because It couples the first order of elastic twist. S v Includes terms of 

3 x 

e only, because it couples the second order of elastic twist. 

5 x ■ JJ A {*, s + ’} G fxj + {*., - $} G 7 X , ^ ds 

■ GJ <*,X * *0> 

= JJ A {^,J + ’} G 7 xf + {*,, - j) G 7 X , d 7 d f 

■ GJ ',x 

The section integrals in Equations (2.6-47a-h) are defined as: 

Modulus weighted area, first and second moments of Inertia, and torsion 
integrals. 

EA = ff E drj d$ ; El = IT E $ 2 dtj (2.6-48a,b) 

JJ A W JJ A 


} (2.6-47g) 


} (2 . 6— 47h) 
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EA* a - JJ E TI d >7 d£ ; 

EI ?f ■ IJ A E ” 2 *' * 

(2.6-48c,d) 

EAf A = JJ E £ di 7 df ; 

A 

EI ,<; ■ 1I a e » f <■* 

(2.6-48e,f) 

EACq = JJ E (* 2 + s 2 ) d »7 d£; 

A 

EACj = JJ E 7 ( 17 2 + £ 2 ) dij d£ 

A 

(2.6-48g,h) 

EAC 2 = |J E f (>? 2 + J 2 ) d 7 d$; EAC 3 -JJ E (jj 2 + $ 2 ) 2 d V dj 

(2.6-481 , j) 

GO ■ {J a G (#., 

* + *) 2 + G (f - £) 2 d >7 d$- 

(2.6-48k) 

Modulus weighted area and first moment warping Integrals: 


EAD 0 ■ JJ M dlj df ; 

““6 ■ JJ a e *,x d ’ d * 

(2.6-49a,b) 

EAD 1 = JJ E f r/ drj d£ ; 

EAD i - JJ a e *. x » d * <* 

(2.6-49c,d) 

EAD 2 - JJ E is d? df ; 

EAD 2 * JJ a E <*,* f d ’ d f 

(2.6-49e,f) 

EAD 3 = JJ E i * 2 dij df ; 

EAD 3 * JJ/ *.x 2 d ’ d ? 

(2.6-49g, h) 

EAD 4 = JJ^E * (»7 2 + £ 2 ) dj;d£; 

EAO a = JJ E * X (|) 2 + f 2 ) d,d S 

A 

(2.6-491 J) 

ead 5 = 

JJ a e * * tX d, d f 

(2.6-49k) 
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The section integrals, which are evaluated over the beam cross sec- 
tion, are defined as follows. The modulus weighted area Is defined as EA. 
The first moments of the modulus weighted area are defined as EAtjh and 
EA£a» where rjfr and are the distances from the shear center to the 

' A A 

modulus weighted area center along e^ and e<j-, respectively. The second 
moments of the modulus weighted area about the shear center are defined as 
EI^, EI^, and EI^£. Higher order constants that are necessary for 
modeling the axial-torsion coupling of the beam are defined as EACq, EACi, 
EAC 2 , and EAC 3 . EACg represents a higher order coupling of the axial and 
planar bending deformations with the nonlinear torsional twist. EAC^ and 
EAC 2 are coupling terms between the torsional twist and the axial 
deflection produced by planar bending deformations. EAC 3 Is a higher order 
term that alters the nonlinear torsional stiffness of the beam. As 
previously mentioned, these constants are negligible when applying the 
ordering scheme In a strict fashion, however they are retained in order to 
capture these terms which are present In previous studies (Ref. 2.6-2, 
2.6-11, and 2.6-13). The quantity GJ Is the modulus weighted torsion 
constant. 

The modulus weighted warping Integrals are defined In Equations 
(2.6-49a-k). The quantity EADq represents the linear and nonlinear 
coupling of the axial deflections and the warping deflections. The term, 
EADq Is used to couple the axial deflections with the variation of the 
warping function over the beam length. This warping function variation is 
produced by either a change In the cross section properties or pretwist 
along the beam length. The constants, EADj and EAD 2 , are terms which 
couple the axial strain due to warping with the axial strain produced by 
planar bending. EADJ and EAD£ represent coupling between the axial strain 
produced by planar deformation and the axial strain produced by the 
variation of the warping function along the beam length ( 1 . e . , beam 
pretwist). The quantities EAD 3 , EAD^, and EAD 5 represent the change of the 
torsional stiffness of the beam due to cross section warping and/or varying 
cross section properties (l.e., beam pretwist). The terms EAD 4 and EAD^ 
are higher order torsion coupling terms. Some of these terms have been 
defined by other authors for either Isotropic materials or symmetric cross 
sections (Ref. 2.6-2). 

For the case of a uniform pretwisted beam, some of the warping 
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For the case of a uniform pretwisted beam, some of the warping 
Integrals can be written In an alternate form by using the Identity In 
Equation (2.6-41): 


*.x = 1 

L - *,s'J r . 

(2.6-50) 

substituting In: 

““o * r o J 


1 S - *,S 1 ) *> * 

(2.6-51a) 

EAD i ■ r o Jj 


1»,, f - «» lf V } 1 *> d S 

(2.6-51b) 

EA °2 ■ T 0 Jj 


s - '.f ’ } f d ’ d * 

(2.6-51C) 

ea0 3 • t o 2 JJ a e ' 

(#., f - *,ff»} 2d ’ds 

(2.6-51d) 

EA0 4 ■ T o If/ ' 


£ - V } (v 2 + ? 2 ) d 7 d £ 

(2.6-51e) 

““5 ’ T o J. 


-tt- 

CS 

CL 

-53 

CL 

(2.6-51f) 


Integrating the strain energy by parts: 

0U = J (Y u ) 6u + (Y y ) 6v + (Y w ) 0w + (Y^) dx + b(U) (2.6-52) 

where 

Y u ■ - { V x } >x (2.6-53a) 

V v ' {”y s1n ^ * ft * ” z cos 0> + f> - S x cos p (* iX sin f - m % c°s/!)} jXX 
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+ S' sin P (v cosy? + w slny?)} (2.6-53b) 



L 


- {m cos (p + f) - M z s1n(^ + ^) + S^s1n/J(v X s1n/J - w |X C0S ^)} fiw f j 


(2.6-54) 

The strain energy variation, 5U (Equations 2.6-52 and 2.6-53), and the 
associated conditions at the boundary, b(W e ) (Equation 2.6-54), contain 
many of the same basic terms as those derived by other authors (Ref. 2.6-2 
and 2.6-3). The additional terms in this development are due to the 
following assumptions: (1) the cross section is not symmetric, (2) the 

effects of beam pretwist and cross section warping are fully Included, and 
(3) the strain energy is derived using a complete moderate deflection 
theory and the second-order effects of the shear strain are Included. 

Three new stress resultants are developed In this study which do not 
appear In previous derivations. The first term, T x , appears in the torsion 
variation, Y^, and Is used to account for the torsion twist of the beam due 
to axial loads. This term Is defined as higher order based on the ordering 
scheme and should be neglected, however for rods which experience consid- 
erable axial loads (l.e., centrifugal forces) this term should be retained. 
The second term, P x , also appears In the torsion variation and is used 
to account for the variation of the cross section warping function along 
the length of the beam. The third term, S x , which appears in the beam 
bending variations represents the coupling between the beam bending defor- 
mations (v,w) and the elastic torsion twist (0). 

2. 6.4.2 Kinetic Energy Contributions 

The total kinetic energy of the beam Is defined as: 

T = 7 f ff /> V • V dij d£ dx (2.6-55) 

c J 0 JJ A 

where V Is the velocity vector of an arbitrary point on the beam with 
respect to the inertial reference frame (I , J , K) . 
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Since It Is assumed that the beam rotates about the spin axis, K, with 
a constant velocity, Q, the velocity vector, V, will have the form: 

V = r Q + Q K x ? Q (2.6-56) 


where r 0 Is the position vector of a point on the deformed cross section 
of the beam in the blade coordinate system (1,j,k). The blade coordinate 
system rotates with the hub about the spin axis with a constant angular 
velocity, Q. 

Writing the vector r 0 : 

? 0 = { h i T + hj 1 + h k Ic } + R (2.6-57) 


where hj , hj, and h|< are the translational offsets of the beam defined In 
the blade coordinate system and R is defined In Equation (2.6-37). 

A 

The position vector r 0 can also be expressed in terms of the element 

AAA 

coordinate system (e x ,ey,e z ) using the transformation matrices defined In 
Equations (2.6-4) and (2.6-5c). 


A 




+ X + u, 


hy + V, 


h z + w) + (yr‘, 



(2.6-58) 


where h x , hy, and h z are the translational offsets of the beam from the 
origin of the blade coordinate system to the origin of the beam coordinate 
system. Expressing the offsets In terms of the element coordinate system 
using Equation (2.6-5c): 

T 

(h x ,h y ,h 2 ) = (h 1 ,hj ,h k )[ T eb ] (2.6-59a) 


and the transformation from the element coordinate system to the vector set 
on the deformed beam, [Tqe]» Is defined using Equations (2.6-4) and 
(2.6-25): 


[ T DE ] * [ T DC ] [ t ce ] 


(2.6-59b) 
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This matrix multiplication Is carried out using Equations (2.6-4) and 
(2.6-28) and substituting for the element deformations (u,v,w). 

[ T DE ] = 


-v v cos(i? + ^) - w s1n(/J + ^) cos(p + ^) 

I X | A 

-w cos (B + 0) + v sin(/J + <f>) -s1n(/f + f + r') 

f X | A w 

where 

r* = {v x cos/J + w x sin/l}{w (X cos£ - v ^ slny?) 

The spin vector Is transformed to the element coordinate system using Equa- 
tions (2.6-1) through (2.6-3): 

fl k Q * Q x e x + D y ®y + °z ®z (2.6-60a) 

where Q Xl Qy, and Q z are defined as: 

(Q x .D y .0 Z ) - (0 ,0 .0 )[ T hi )[ T bh ][ T eb ] (2.6-60b) 

The pitch, precone, and sweep settings of the blade, as well as orientation 
of the beam element with respect to the blade coordinate system, are Im- 
plicitly defined within the rotational constants; 0 X , Qy, and Q z . 

The total velocity vector, V, Is calculated by substituting in the 
time derivative of Equation (2.6-58) along with the cross product of the 
spin vector (Equation (2.6-60a)) and the vector r 0 (Equation (2.6-58)). 

The ordering scheme Is used and terms of order and are retained. 

V = {u + Q y {h z + w} + (Q y - W |X ){£ cos(£ + &) + V sin (p + 4)} 



s1n(/J + *) 
cos {p + 0) 
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- Q z {h y + v} - (Q z + V (X ){j 7 cos (p + &) - $■ sin {p + £)}} e x 
+ {v + Q z {h x + x + u} - (Q x + ^){$- cos (p + i) + 7 sin (p + ^)} 

-0 x (h z + w} - 0 Z {(»7 v x + £ W |X )cos/> + (7 w^ x - V jX )s1n^}} e y 

+ {w - Q y {h x + x + 11 } + (fl x + {7 cosO? + i) - £ si n (/? + £)} 

+D x {h y + v} + 0 y {(7 V jX + £ W |X )cos /1 + (7 W fX - £ V fX )s 1 n£}} e z 


(2.6-61) 

The variation of the kinetic energy, 61, for the beam Is defined as: 

$T = f ff p V*5V d 7 dc dx (2.6-62) 

J 0 JJ k 

A A 

where V, Is the total velocity vector (Equation (2.6-61)), 5V Is the 
variation of the total velocity vector, and p Is the mass density of the 
beam. 

The variation of the kinetic energy, 61, Is calculated by taking the 
dot product of the velocity vector, V, with the variation of the velocity 

A 

vector, 5V, Integrating by parts with respect to time, and finally 
Integrating over the cross section. From Hamilton's principle, the 
variation of the kinetic energy, 5T, is an extremum over the time Integral 
from ti$t$t 2 . 

Since the velocity vector and the variation of the velocity vector are 
both of order e 1 and the resulting variation of the kinetic energy, $T, 
will be of order e 2, e 3, and e^. Consistent with the ordering scheme, 
terms of order are neglected due to the presence of e 2 terms. 
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Integrating 61 by parts with respect to time between two arbitrary 
points, ti and t2, and then over the cross section, one obtains: 


6 T 


= J L (Z U 6u + Z v ffv + z; + Z w 5w + z; 5w >x + Z^ ty) dx (2.6-63) 


where, 

Z u = m{-u - 2 (Q y w - Q z 0 ) + (fl y 2 + n z 2 ) (h x + x + u) - Q x Q y 

- Q x Q z (h z + w)} - (m ij m cos/J - sin/J) {q x fl y ) 

- 0% cos p + iro/ m sin/J){n x flj 


(h y + v) 


(2.6-64a) 


Z v = m{-v + 2 (Q x w - n z u) - n x n y (h x + x + u) + (Q x 2 + Q z 2 ) (h y + V) 

- Q y Q z (h z + w)} + (m»7 m cos p - m£ m sin/?) {2 (0 X '<j> + Q z v x ) 

+ Q x Q y V jX + (Q x 2 + n z 2 ) - 4> n y Q z ) + K m cos/J + mrj m s1n/J){'£ 

+ 2 Q z W jX + Q x Q y W |X - <f> (Q x 2 + Q z 2 ) - 0 y Q z ) (2.6-64b) 

I; = (m % cos/J - m ?m SI17/?) {2 ( 0 y w - Q z v) - (Q y 2 + Q z 2 ) (h x + x) 

+ Q x Q y (h y + v) + fi x fi z (h z + w)} - (m£ m cos/J + m rj m sln/J) {fi y h z $ 

- 0 Z h y ) - * {(n y 2 + n z 2 )(h x + X) - Q x o y h y - fl x n z h z )} 

+ fl x Q y {im^ cos 2 /J + Im^ sin 2 /J - 2 Im^ cos p sin/j} 
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+ (m£ m cos p + mri m s1n/?){*v - 2 Q x w + (D y h z - Q z h y ) v >x 

+ Q x Q y (h x + x) - (Q x 2 + n z 2 ) (h y + v) + Q y D z (h z + w) 

+ v ,x^ Q y 2 + Q z 2 )< h x + x > " °x n y h y ’ Q x Q z h z>) 

+ * »x Q z (h x + x ) + Q y fl z h y " (n X 2 + °y 2) h z } } " ( Itn r>n + 1 V } 

- (Q x 2 + Q z 2 ){l^ ? (cos 2 p - sln 2 ^) + (Im^. - Im^) cosp sin^} 

+ (Q x 2 + Q y 2 ){ Im ^ (cos 2 /? ~ s1n2 />) + ( Im ^ " lm ijJ C0S P s1r W 

+ Q y Q z (im^ cos 2 /? + Im^ sin 2 /? + 2 Im^ cosp sin/?} 

- Q y Q z {im^ cos 2 p + Im^ sln 2 ^ - 2 Im^ cos p sln^} (2.6-64f) 

where the double underlined terms are of order and, based on the order- 
ing scheme, should oe neglected. These terms are retained In this develop- 
ment to correctly model the axial Inertia, axial centrifugal forces, and 
the torsion Inertia. 

The section Integrals In Equations (5.64a-f) are defined as: 


m = ff p drf d£ ; 
JJ A 

"> - J 

ff p £ 2 d< ? d £ 

U A 

(2.6-65a,b) 

m V m s ff P V d> 7 d £ ; 
A 

“■« ' i 

If P V 2 d V d £ 
U A 

(2.6-65c,d) 

■Sin * IJ/ S d ’ d S • 

In W = . 

f f P V £ d »? d S 
U A 

(2.6-65e, f) 
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where m Is equal to the mass of the cross section. The first mass moments 
of the cross section about the shear center are defined as mj 7 m and mf m . 

The second mass moments of the cross section about the shear center are 
defined as Im^, Im^, and Im^. 

Integrating the kinetic energy (Equation 2.6-63) by parts: 

61 = Jg{ V U + (I v " ^v,x )5v + (7 w • Zw,x )ffw + y*} dx + b ( T ) (2.6-66) 


writing the equilibrium conditions at the boundary, b(T): 

. L . L 

b(T) = Z' <5v + Z' 6vi\ (2.6-67) 

v i Q w 'o 


2. 6. 4. 3 External Work Contributions 

The principal of virtual work is used to Include the effects of non- 
conservative distributed loads and moments that act along the line of shear 
centers. These distributed loads and moments are defined In the element 

AAA 

coordinate system (e x ,ey,e z ). Virtual work is the work done by the 
distributed loads and moments acting through virtual displacements and 
rotations about the deformed equilibrium position. 

The virtual work due to the distributed loads along the line of shear 
centers, Is calculated by taking the dot product of the real distributed 
forces and the virtual displacements and Integrating over the beam length. 

r L 

5VT = (p <5u + p <5v + p 0w) dx (2.6-68) 

e p J o * “ z 


The virtual work, due to the distributed moments along the line of 
shear centers, Is calculated by taking the dot product of the real dis- 
tributed moments with the virtual rotations and Integrating over the beam 
length. 




0 Z v ,x> 5u , x + <«z - w ,x> 4v ,x 
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(2.6-69) 


+ K \x ' V SW .X + <q x + q y V ,X * q z W .x>^ dx 

The total virtual work Is calculated by combining the virtual work due 
to distributed loads (Equation (2.6-68)) and the virtual work due to 
distributed moments (Equation (2.6-69)) and Integrating by parts. 


<5W 


* J*>x - < q y \x - q z \x>,x> 5u + ‘ (q z * q x w ,x>.x> Sv 


+ frz * fry ' q x v ,x>.x }Sw + (q x + v ,x * "z w ,x> 5 ' dx 


+ b(W e ) 


(2.6-70) 


writing the equilibrium conditions at the boundary, b(W e ): 

b(W e ) - (q y W fX - q z V tX )«u| + (q z - q x « tX )«v| + (q x v x - q y )6w| (2.6-71) 


2. 6. 4. 4 Summary of the Partial Differential Equations 
of Motion and Boundary Conditions 

The partial differential equations of motion and the associated bound- 
ary conditions are calculated by substituting the variation of the strain 
energy, 6U (Equation 2.6-52), the variation of the kinetic energy, 61 
(Equation 2.6-66), and the virtual work of the external loads, $W e 
(Equation 2.6-70), Into Hamilton's principle. There are two requirements 
that must be met In order for Hamilton's principle to be identically equal 
to zero and thus, the total dynamic potential to be an extremum. 

.The first Is that all the terms Inside of the Integral must be Iden- 
tically equal to zero. Since the variations of the variables (5u,6v,6w,6^) 
are arbitrary over the length of the beam then, In order for all of the 
terms to be equal to zero, the functions multiplied by these variations 
must be zero. The four functions which are associated with the four 
variations are the equations of motion of the beam. 

Second, the sum of the equilibrium conditions at the boundary due to 
the strain energy variation, b(U), the kinetic energy variation, b(T), and 
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the virtual work, b(W e ), must also be zero at x = 0 and x = L. These con- 
ditions are used to obtain the boundary condition of the beam element. 


The four equations of motion are: 
ffu equation: 

ftc - «y w ,x + «z V ,x),x + \ + Px - 0 < 2 - 6 - 72 > 

gv equation: 

{M y sin + ^) + M z cos {p + 0) - cos p {V fX s1n£ - cos£}} xx 

+ ft s1n /’ < v .xx * w ,xx s1n « - 7 x v .x + 2 ; - "x w ,x + 'IzJ.x 

- Z v - p y = 0 (2.6-73) 

gw equation: 

{m z s1n(£ + ^) - My cos (/? + <p) - S; sin p {v >x sinp - w^ x cos£}} xx 

- fo < v .xx cos f * w .xx s, "fl + 7 x \x - ^ - "x \x + "yj.x 

- Z w - p z = 0 (2.6-74) 

6± equation: 

{ p x),xx * { S x + p x + V.x l.x + ^ M y + + M z cos ^ + w ,xx 

{M y cos (/> * fl - M z s1n(0 + *)} V iXX - if - q y v_ x - q z w_ x - q x = o 

(2.6-75) 
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The equilibrium conditions at the boundary are: 


b(U) - b(T) - b(W e ) • {v XjX + q z v_ x - q y w 

+ {M y s1n(£ + f) + M z cos (p + ^) - cos p ( v fX s1n A - w fX cos£}}$v 
+ {{\ \x ■ s1n ^ {v ,xx cos ^ + w ,xx s1 ^ } - + q x w .x - <<z} 

I 

- {fi y s1n(£ + ^) + M z cos(/> + 0) - cos /? (V fX sln^ - w ^ cos/?}} (X }5v| 

+ [M z s1n(^ + - M y cos (/? + <p) - S' x s1n£ {v^ sln^ - w x cos£}}$W fX |^ 

+ {{ 7 X w ,x + 5 i co ^ tv .xx cos ^ + “.XX s,n « - ? W ■ q x v ,x + «y} 

- |M z s1n(/J + f) - M y cos (/? + f) - S' sin/? {v^ x sin/? - ".x “**>}. xW 





(2.6-76) 


where the stress resultants (V X ,P X ,P X ,T X ) anc * t * ie moment resultants 
(S x ,S x ,My,M z ) have been defined In Equations (2.6-46a-f) and (2.6-47a,b). 
The Inertial forces (Z U ,Z V ,Z W ) and the Inertial moments (Z V ,Z W ,Z^) are 
defined In Equations (2.6-64a-f). 


2.6.5 


Finite Element Discretization of the Equations of Motion Usinc 



The equations of motion, which have been derived In the previous sec- 
tion, are a set of nonlinear partial differential equations. They are 
nonlinear in terms of the space dependent variables. In order to do the 
free vibration analysis of a rotating propeller, these equations are solved 
by assuming that the displacements are a superposition of functions which 
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are space dependent and time dependent. The space-dependent displacement 
functions are determined by solving the time-independent nonlinear partial 
differential equations (l.e., neglect all time-dependent terms). Introdu- 
cing this nonlinear space-dependent solution Into the nonlinear partial 
differential equations results In a standard eigenvalue problem for the 
time-dependent function, the solution to which yields the natural frequen- 
cies and mode shapes of the rotating blade. 

The solution of the nonlinear partial differential equations can be 
determined using approximate methods. Three methods that have been used 
successfully are the Rltz method, the Galerkln method, and the finite 
element method. A detailed discussion of these methods can be found In 
References 2.6-22 through 2.6-25. For this analysis, the finite element is 
applied. 

The finite element method is a generalized form of the Rltz method 
with all of the advantages and few, if any, of the disadvantages. This 
method Is a piecewise application of the variational method. The solution 
procedure Is not based on solving the nonlinear differential equations of 
motion, but on minimizing the total dynamic potential of the rotating 
blade. The variation of the total dynamic potential with respect to the 
displacements Is equal to zero when the total dynamic potential Is 
minimized (l.e., apply Hamilton's principle to each subregion). 

Writing Hamilton's principle In discretized form: 



II (<5U 1 - 6T 1 - $W el ) dt = 0 


(2.6-77) 


where 

n = number of finite elements In the model 

tfUj = variation of the strain energy In the 1*h element 

*Tl = variation of the kinetic energy In the 1*h element 

*We1 = virtual work of the external forces In the 1*h element 

The solution for the displacement function will solve the nonlinear 
differential equations of motion and the natural boundary conditions which 
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are Implicitly contained In the total dynamic potential. This has been 
shown using the calculus of variations (Ref. 2.6-20). 

The blade Is divided Into subregions (beam type finite elements) and 
the variation of the total dynamic potential Is applied to each subregion 
using a set of Interpolation functions for the displacements. Since the 
Interpolation functions are not defined over the entire domain, they are 
not required to solve the boundary conditions, but they have to satisfy 
convergence criteria (completeness and continuity). 

Writing the displacements In terms of space dependent interpolation 
functions and time dependent functions: 







(2.6-78) 


where {$ v }, {$ w }, {fy}, and ($ u ) are space dependent Interpolation func- 
tions and {V}, {W}, ty], and {U} are time dependent functions of v, w, 0, 
and u. 

Similarly, the variation of the displacements are written as: 


6v T 

{»V> 

0 

0 

0 

f{5V} 

ffw 

6 f " 

0 

0 

(*w) 

0 

0 

{♦*} 

0 

0 

, (5W) 

m 

ffu J 

. 0 

0 

o f 

{* u } J 

UffU] 


(2.6-79) 


Substituting the displacements (Equation 2.6-78) and the variations of the 
displacements (Equation 2.6-79) Into the l^h element of the discretized 
form of Hamilton's principle (Equation 2.6-77) and carrying out the 
Integration will produce the following matrix equations: 

C 2 m{[ " ]{«} ♦ [ « c m + [[ * T i * k l m]]w + { fT }) dt • w 

t i 

(2.6-80) 
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where. 


{q} = Nodal deformation array 

W T ■ {{V}T,{W}T,{rtT, {U jT } 

{5q} ■ Variation of the deformation array 

(*q} T = {5W}I, {5^}T, {5U}I } 

All of the matrices that are produced represent a complete set of 
self-adjoint finite elements (l.e., symmetric linear and nonlinear Jacobian 
matrices and antisymmetric Coriolis matrix). This occurs because the 
ordering scheme is applied to each of the energies (strain energy, kinetic 
energy, potential energy) Instead of the equations of motion. 


Since the virtual displacements (5v,5w,£^,£u) are arbitrary over the time 
Integral, then the variation of the deformation array, {{$V} T , 

{0U}T}, is also arbitrary In the discretized form of Hamilton's principle 
and the equations of motion can be easily written from Equation (2.6-80): 


[ M ]W + [ * ]{«} - [[ < T ] - [x NL fqj]]{q) ♦ {f 1 } - {0} ( 2 . 6 - 81 ) 


In this development, the finite element matrices are generated using 
Hermlte Interpolation polynomials that are substituted Into the variation 
of Hamilton's principle (Equation 2.6-42). A cubic Hermlte interpolation 
polynomial Is used for the planar deflections (v,w) and a quadratic Hermite 
polynomial Is used for the axial deflection (u) and the torsional rotation 

W- 

The cubic Hermlte Interpolation polynomial Is Ideally suited for the 
development of the beam bending finite element for the following reasons. 

It guarantees uniform convergence by having the required rigid body dis- 
placement, rigid body rotation, and constant curvature modes. The bending 
strains vary linearly over the element length, which goes beyond the re- 
quirement of a constant strain mode. The resulting elements formed using 
this polynomial will have Interelement compatibility for both displacements 
and slopes. The nodal parameters are the displacements and slopes at 
either end of the beam. 
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The quadratic Hermlte Interpolation polynomial was chosen for the 
axial deflection (u) and the torsional rotation (^) because It has a higher 
level of accuracy than the linear Hermlte Interpolation polynomial. This 
same torsional model (1.e. t quadratic polynomial) was used successfully In 
previous finite element studies of helicopter rotor aeroelastlclty (Ref. 
2.6-23). Both the linear and the quadratic polynomials satisfy all the 
convergence requirements, but the quadratic polynomial also has the 
capability of modeling the linear variation of strain along the element 
length. The quadratic polynomial Is used to generate an axial and a 
torsion element which has the same level of accuracy as the beam bending 
element. This allows the discretization of the model for torsion or 
axially loaded analysis to be the same as for a bending analysis. The 
nodal parameters for the axial element and the torsion element are chosen 
as the two element boundaries and the element mid-point. 

The resulting beam finite element has 14 nodal parameters; four In- 
plane deflections, four out-of-plane deflections, three axial deflections 
and three torsion deflections. They are defined as six parameters (three 
deflections, three rotations) at each end of the beam and two parameters 
(one axial deflection, one torsion deflection) at the mid-point of the 
element (Figure 2.6-6). The mid-point node Is condensed from the element 
after formation using the assumption that the axial and torsion loads on 
the element can be fully described using the two end nodes only (l.e., 
external loads on the mid-point node are equal to zero). Condensing out 
the mid-point node will reduce size of the matrices and the bandwidth of 
the overall model without sacrificing the accuracy of the calculation. 

The removal of the mid-point node Is done by either static con- 
densation (Ref. 2.6-24) or Guyan reduction (Ref. 2.6-26). In this study, 
static condensation Is used to eliminate the element mid-point node from 
the static equations of equilibrium. Guyan reduction Is used to eliminate 
the element mid-point node from the dynamic equations of motion. The beam 
finite element In Its final form will have 12 nodal parameters; three 
deflections and three rotations at each end of the beam. 

All of the beam finite elements are defined with a linear variation in 
properties and loads between the two end nodes. This will increase the 
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convergence rate and reduce the number of elements that are required for 
modeling nonuni form blades. 

Assembly of the finite elements Into system matrices and enforcement 
of the geometric boundary conditions Is handled as In the conventional 
finite element method (Ref. 2.6-25). 

2. 6. 5.1 Finite Elements Associated With the Strain Energy Variation 

The linear and nonlinear stiffness matrices are derived by sub- 
stituting the assumed shape functions Into the strain energy variation, 6U 
(Equation 2.6-46), and carrying out the Integration over the length of the 
beam. Hermlte cubic interpolation functions {$ c } are used for the planar 
deformations (v,w) and for the variation of the planar deformations 
(ffv,0w). Hermlte quadratic Interpolation functions {$q} are used for the 
axial deformation and torsional twist (u,^) and also for the variations of 
the axial deformation and torsional twist (ffu.ty). The small angle 
assumption for ^ (Equation 2.6-31e) Is used for all trigonometric relations 
of the strain energy variation. The matrix relations will be self-adjoint 
because the ordering scheme was applied to the strain energy. 

The resulting variation of the the strain energy will have the form: 



where, 

[ K*" j Is a linear finite element stiffness matrix associated 
with elastic forces (symmetric), detailed expressions 
for this matrix are presented In Appendix A.l 


[ K ^{q}] Is a nonlinear finite element stiffness matrix asso- 
ciated with elastic forces (nonsymmetrlc) , detailed 
expressions for this matrix are presented In Appen- 
dix A.l. 
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T 

{q} - {{U}, {V}. {«, {W}} 

The solution of nonlinear finite element equations requires an Itera- 
tive method [for example, Newton-Raphson method (Ref. 2.6-21), Brown's 
algorithm (Ref. 2.6-27), etc.]. Typical studies of this type for rotor 
blades (Ref. 2.6-23 and 2.6-28) have been based upon the Newton-Raphson 
method. Such methods require the calculation of the Jacobian matrix, which 
Is the derivative of the of the linear and nonlinear elastic forces with 
respect to the deflections (v,w,^,u). 

Writing the linear and nonlinear elastic forces. 


fkl 

+ 

’ k nl . 

[ q ] 

■ 

t 

cr 

> 




. 

J l J 


where 


T 

{q} ■ {{U}, {V}, {((}, tW)} 


Defining the Jacobian as the derivative of the elastic forces with respect 
to the deflections 



(2.6-84) 


The linear Jacobian matrix Is equal to the linear stiffness matrix: 


J 




(2.6-85) 


The nonlinear Jacobian matrix is equal to the derivative of the nonlinear 
elastic forces with respect to the deflections. 




( 2 . 6 - 86 ) 
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where the terms which constitute the nonlinear Jacobian matrix are pre- 
sented In Appendix A.l. 

2. 6. 5. 2 Finite Elements Associated With the Kinetic Energy Variation 

All of the finite element matrices, which are associated with the 
kinetic energy of the rotating beam, are derived by substitution of the 
shape functions Into the kinetic energy variation, 0T, and Integrating over 
the beam element length. The shape functions which are chosen are: the 

Hermlte cubic Interpolation functions {* c } for the planar deformations 
(v,w) and the variation of the planar deformations (ffv.ffw), and the Hermlte 
quadratic Interpolation functions {$ q } for the axial deformation and tor- 
sional twist (u,l) and also for the variations of the axial deformation and 
torsional twist ($u,ty). 

The discretization of the kinetic energy leads to three linear matri- 
ces and one column matrix. The three matrices are a symmetric mass matrix, 
an antisymmetric Coriolis damping matrix, and a symmetric centrifugal 
stiffening matrix. The column matrix Is the result of the centrifugal 
force. The small angle assumptions of Equation (2.6-31e) are used to 
linearize the trigonometric functions. 


The following matrix relation Is written by substituting the shape 
functions Into the kinetic energy variation (Equation 2.6-63) and 
Integrating over the element length. 


T 



(2.6-87) 


where 


[ M j = mass matrix (symmetric) 

[ M C ] = Coriolis damping matrix (anti -symmetric) 

[ K^j = centrifugal stiffening matrix (symmetric) 
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{f CF } = centrifugal force array 


where detailed expressions for the three finite element matrices and the 
column matrix are presented In Appendix A. 2. 

2. 6. 5. 3 Finite Elements Associated With the Virtual Work Variation 

The finite elements associated with external work are calculated by 
substituting the Hermlte Interpolation functions Into the definition of the 
variation of external work and Integrating over the beam length. 



( 2 . 6 - 88 ) 


where 

^ K* j = applied moment stiffening matrix 


{f 1 } = applied force array 

where detailed expressions for the matrices are presented In Appendix A. 3. 

2. 6. 5. 4 Summary of Finite Element Equations 

The equations of motion are written by substituting the strain energy 
variation (Equation 2.6-82), the kinetic energy variation (Equation 
2.6-87), and the variation of the work of external forces (Equation 2.6-88) 
Into the discretized form of Hamilton's principle (Equation 2.6-77). Since 
the variation of the displacements (5v,$w,ty,$u) are arbitrary over the 
Integral, this Implies that the Integral will equal zero only If the matrix 
equation, (Equation 2.6-80), Is Identically equal to zero, thus: 

[ M ]{«} + [ mC ]{<} + [[ k T ] + [k NL {<i}]]M ♦ {f 1 } * {»} ( 2 - 6 - 89 > 
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where; 


[ K T ] . [ K L ] + [ K CF ] ♦ [ K 1 ] 

F) * P*} * M 

T 

{q} - {{U}, {V}, {«, {W}} 

2.6.6 Method of Solution 

The solution of the structural dynamic analysis of the rotating pro- 
peller Is accomplished in two steps. The first step is to solve for the 
nonlinear static equilibrium position of the blade using a Newton-Raphson 
iteration scheme; this procedure has been used in similar studies (Ref. 
2.6-22 and 2.6-23). The second step is to solve for the natural 
frequencies of vibration of the nonlinear equations of motion by assuming 
that the motion Is a small linear perturbation about the static equilibrium 
position. 

2.6.6. 1 Static Analysis 

The solution for the nonlinear static equilibrium position Is accom- 
plished by neglecting the time-dependent terms In the equations of motion 
and using a Newton-Raphson Iteration scheme to solve the nonlinear equa- 
tions of equilibrium. The Newton-Raphson scheme, which is based on a Tay- 
lor series expansion, has proven Itself as one of the best solution tech- 
niques available In geometrically nonlinear analyses (Ref. 2.6-29) and Is 
used routinely In rotor blade dynamics (Ref. 2.6-22 and 2.6-23). This 
method Is extremely accurate and possesses second-order convergence. In 
this study the Iteration Is considered to have converged when the absolute 
change of all the deformations is less than 10 -4 for each cycle. 

For the case of free vibration for a rotating blade, the nonlinear 
equilibrium state of the blade can be considered to be Independent of time. 
Thus the static equations of equilibrium of the rotating blade are obtained 
by neglecting the time dependent terms of Equation (2.6-89): 
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(f<q)} ■ [[ K T ] ♦ [K NL {q}]]{q) ♦ {f 1 } * { 0 } (2.6-90) 

where [K T ], [K NL {q}], {q}, and {F T } have been defined In Equations (2.6-82) 
and (2.6-89). 

The Newton-Raphson Iteration scheme Is applied by writing the linear- 
ized form of the Taylor series expansion of Equation (2.6-90). The 
Increment for each step of the Iteration Is defined by n. 

{f(q)} - { f (q>} + fq { f (q)} {{«} -{"}} * M < 2 - 6 - 91 > 

n+1 n n n+1 n 

Solving for the deflected shape at the new Iteration step: 

{q} * {q} + [ J{qj] {f(q)} (2-6-92) 

n+1 n n n 

where the matrix [J{q}] Is defined as the Jacobian matrix. 

[ J W] * fq ( f Cq)} (2-6-93) 

n n 

Taking the derivative of the function f(q) with respect to the deflec- 
ted shape, {q}, In Equation (2.6-90) will produce two components of the 
Jacobian matrix; a linear Jacobian matrix and a nonlinear Jacobian matrix. 
Both components are symmetric matrices due to the application of the order- 
ing scheme to the strain energy. 

[ J(q}] - [ J L ] + [ J NL {q}] (2.6-94) 

n n 

where the linear Jacobian matrix [J*-] is equal to the total linear stiff- 
ness matrix [K^] and the nonlinear Jacobian matrix [J^*-{q}] is equal to the 
derivative of the nonlinear elastic forces with respect to the deflections: 

[ J L ] = [ K T ] (2.6-95a) 
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(2.6-95b) 


[ 0 %,] - 4 ; {[^ {,}]{,}} 

n n n 

The nonlinear equilibrium position for each iteration cycle is calcul- 
ated using Equation (2.6-92) along with equilibrium position from the 
previous cycle, the definition of the Jacobian matrix (Equation 2.6-94 and 
2.6-95), and the total forcing function (Equation 2.6-90). 

The linear solution of the nonlinear equations of equilibrium is cal- 
culated during the first cycle of the iteration scheme, because the initial 
guess in the iteration is taken by setting all of the nonlinear effects 
equal to zero. 

The nonlinear static equilibrium positions are used to calculate the 
element forces, the hub shear forces and moments, and the stresses within 
the blade. 

2. 6. 6. 2 Structural Dynamic Analysis 

The mode shapes and natural frequencies of vibration of the rotating 
blade are calculated by linearizing the nonlinear equations of motion. 

This is accomplished by assuming that the vibration is a small linear 
perturbation, {Aq}, about the nonlinear static equilibrium position, and 
neglecting products of the perturbation quantities (i.e., Aq-jAqj = 0). 

[ M ]W + + [[ 1(1 ] + [j NL (q}]]{Aq} = {o} (2.6-96) 

n 

Since the effects of structural damping have been neglected, the above 
equation will reduce to a standard eigenvalue problem based on a previous 
work (Ref. 2.6-30). 

The linearized equations of motion can be written as: 

M ] {Aq} + [[ K T ] + [j NL {q}]] {Aq} = {o} (2.6-97) 

n 

Equations (2.6-97) are solved by standard eigenvalue techniques. The 
calculated eigenvalues are the squares of the natural frequencies of vibra- 
tion and the corresponding eigenvectors are equal to the mode shapes. 
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2.6.7 Determination of the Shear Center and Structural 
Constants of a Cross Section of Arbitrary Shape 

The static and dynamic behavior of advanced turbo-propellers is influ- 
enced by the coordinates of the shear center, the area and mass center, as 
well as the bending and shear stiffness. However, the location of the 
shear center cannot be easily found, except for simple cross sections 
(i.e., single or multicelled thin walled closed sections) because it 
entails determining the shear stress distribution (St. Venant bending 
function) within the cross section. The exact solution for the St. Venant 
bending function of an arbitrary shaped cross section would be highly 
intractable based on three-dimensional elasticity theory. In this section, 
a model for determining the shear center location and the structural 
properties of a cross section will be developed based on an approximate 
solution procedure (i.e., finite element method) using the general three- 
dimensional elasticity theory. 

The determination of the cross section warping distribution, shear 
center location, and other section constants is determined by the following 
steps. 

(1) The total potential energy of a tip-loaded cantilever beam with a 
user-defined cross section is derived. 

(2) The out-of-plane warping (shear, torsion) of the cross section is 
determined based upon applying the principle of minimum total 
potential energy to a discretized representation of the cross 
section (finite element representation). 

(3) This warping distribution coupled with the generalized 
displacement of the beam are used to determine the stress 
distribution within the tip cross section. 

(4) The cross section equations of equilibrium are applied to tip 
cross section in order to locate the shear center. 
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(5) The remaining section constants (2.6-48, 2.6-49) are calculated 
by numerically Integrating the calculated warping distribution 
over the cross section definition. 

2.6.7. 1 Basic Assumptions Used In the Analysis 

The following assumptions are used in the development of the model. 

(1) The uniform cantilever beam Is defined having an arbitrary cross 
section shape. 

(2) The coordinate system of the beam is defined with the origin 
located at the area center of the beam root. The z axis 
coincides with the area centroid of the beam. The x and y axes 
align with the principal axes of the cross section (Figure 
2.6-9). 

(3) The beam Is subjected to two applied tip loads, V x and Vy, which 
act along the x and y axes, respectively. The twist moment acts 
about the z axis at the tip of the beam. The effects of body 
forces are neglected. 

(4) The stresses, a xx , oyy, and r X y, are neglected based on the use 
of St. Venant assumptions. 

(5) The stresses along the contour of the cylindrical surface of the 
beam surface are equal to zero (i.e., stress boundary 
conditions) . 

2. 6. 7. 2 Total Potential Energy of a Tip Loaded Cantilever Beam 

The total potential energy, n, of a tip-loaded cantilever beam is 
derived based on the theory of elasticity (Refs. 2.6-31 and 2.6-32). The 
strain energy, U, of the beam is derived first using the stress components 
of the cantilever beam. The work of the external forces, W e , is calculated 
based on the assumption that the tip deflections are the average 
deflections of the cross section due to the applied loads. 
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The normal stress, a zz , Is written based on the above assumptions: 

x V y V 

o zz = - - z) - — r-^(L - z) (2.6-98) 

yy xx 

where I xx and Iyy are moments of Inertia about the principal axes of the 
cross section, x and y. 

The solution for the two remaining shear stresses (‘r xz ,ry 2 ) are deter- 
mined using the equations of equilibrium and the stress boundary conditions 
(for a detailed development, Refs. 2.6-31 and 2.6-32): 



(2.6-99b) 

where 8 is the torsional twist of the cross section, ^ is the St. Venant 
torsion warping function, and y is the St. Venant transverse shear warping 
function. 

The displacement state of the beam Is determined by integrating the 
stresses (Equations 2.6-98 and 2.6-99) and by making use of the stress 
boundary conditions, Hooke's law, and the strain displacement relations 
(Refs. 2.6-31 and 2.6-32). The boundary conditions, at the beam root, are 
defined by setting the average values of the displacements and rotations 
over the whole cross section equal to zero. 

u(x,y,z) = 2ll^[ u { x2 ' y 2 }( L ' z ) + f"( 3L * Z )J + E^-jvxyU - z)J - 0 y z 
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y lKx,y)dxdy (2.6-100b) 


y *(x,y) dA + 2Efi y x( x .y) dA 
xx xxJJ. 




y v f 
J x 


2EI I 
yy xxj 


y v 

y y(x,y)dA - 2 ei^y 


XX XXJJ 


y *(x,y)dA - 


XXJ 


y iKx.y)dA 


I 

A 


f v. 


♦ A. 


2EI yy 2EI xxj 


*(x,y) dA - f 


|Kx,y) dA (2.6-100c) 


A 


The strain energy, U, is defined as: 

U = if f f («r e + o’ € + a e + t 7 +T7 + r f ) dA dz 

2J 0 J J A v xx xx yy yy zz zz yz 7 yz xz^xz xy*xy' 


The strain energy is rewritten by substituting in the stresses and 
carrying out the integration over the beam length: 


“■i 


x + 


El... El. 



l ^ 2 )] 

J 3 Gl yz J 

i Gl xz J 

J 


dA (2.6-101) 


where the shear stresses, Ty Z and r xz , are defined in Equation (2.6-99). 

The work of external forces, W e , of the cantilever beam subjected to 
tip shear forces, V x and Vy, and a tip twist moment, Mt is given by: 

w e = V x »u ] + V •v ] + M t «0 (2.6-102) 

where u] and vj are the average tip deflections calculated from Equations 
( 2 . 6 - 100 a) and ( 2 . 6 - 100 b), respectively. 8 Is the average tip rotation 
about the z axis. The tip displacements are given by: 


l v x rr l v v 

U 1 = 2EI I x ^^ X A) dA + 2 pj t 

yy yyJJ A ‘“xx^yyj 


x *(x,y) dA + 

v yy- 


Ik, 

EI yyl 2A V 


XX 


1 L 3 '* 

! yy) + r 


x j»(x,y) dA 


(2.6-103a) 
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L V. 


v-, = 


1 2EI yy I xxj 


A 


L V v 

y y(x.y) dA + 2£j j 

XX XXJ 


«ii. 


y jr(x.y) dA + -? — y jKx.y) dA 


El 


xx 


JjE/l _ i ) + — 

2Al i yy A xxJ 3 


(2.6-103b) 


□ = g _ - — . — . 

8 8 2EI 7! +1 T 

yy v xx yy' 


x 2 y + y 3 dA + 2EI (I L ?i ) 

^tx xx ' J, xx A yy' j 


y 2 x + x 3 dA 


(2.6-103C) 


The total potential energy, II, of the cantilever beam, which is the 
difference between the strain energy and the work of external forces, is 
expressed as: 


n= I 


rx v. 


EI 


"A' 


yy 


» v yl 

,! 1 + Lf 2) 

+ Lf 

T 2)' 

EI *xJ 

3 Gl r yz i 

+ Gl 

r xz J 


dA - V x *u-| - V *v - 1 - M t «8 


(2.6-104) 


where the shear stresses, r xz and Ty Z , are defined In Equation (2.6-98) and 
the average displacements, U] , V| , and 8, are defined in Equation 
(2.6-103). 

2. 6. 7. 3 Solution of the St. Venant Functions 
by the Finite Element Method 

A closed form solution of the St. Venant bending function, y, and the 
torsion function, can only be determined for a few simple cross sections 
(i.e., circle, ellipse, rectangle, etc.) because of the difficulty in sol- 
ving the two-dimensional elasticity problem. The finite element method has 
been shown to be a reliable method for the solution of two-dimensional 
elasticity problems (i.e., plane stress, plane strain) because it can model 
structures of arbitrary shape. 
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The finite element method Is a piecewise application of the variation- 
al principle. The solution procedure Is not based on solving the governing 
equations of equilibrium, but the minimization of the total potential ener- 
gy of the beam. In order to minimize the total potential energy, the first 
variation of the total potential with respect to the dependent variables 
(1 .e. , y(x,y) and jKx,y)) must equal zero. The solution will satisfy both 
the differential equations of equilibrium and the natural boundary condi- 
tions. 

This method is applied by discretizing the cross section into subre- 
gions (finite elements) and taking the local variation of each region. A 
three node triangular element, with a two-dimensional linear polynomial, 
has been used by other authors for the solution of two-dimensional elastic- 
ity problems (Refs. 2.6-33 and 2.6-34). This linear interpolation function 
will lead to a fully conforming element that monotonical ly converges to 
exact solution when the mesh is refined. 

A two dimensional linear serendipity interpolation polynomial Is used 
for both the St. Venant functions and the coordinate definitions. Writing 
In matrix form: 


1 »(x.y) ra = {*(fi,ff 2 )}{it}" 


x m * fN( fl ,f 2 )}{x} m 
y m - {N(s- 1 ,ff 2 )}{Y} ra 


(2.6-105) 


where the linear Interpolation function for the m** 1 element Is defined as 
N(fi,f2) and and & are generalized coordinates. 

Writing the variation of the St. Venant functions in matrix form: 
«*(x,y) m = {N(f 1 ,f 2 )}{«y} ra Sf m = {N( fl ,s 2 )}{5^} ra (2.6-106) 


A set of linear equations Is obtained by substituting the functions 
(Equation 2.6-105) and the variations of the functions (Equation 2.6-106), 
into the variation of the element total potential energy and carrying out 
the integration over the element area. Standard finite element procedures 


01-168-86 


2-298 


are used to assemble the finite elements into a global set of linear 
equations. The solution of these equations is the distribution of the St. 
Venant functions over the cross section. 



(2.6-107) 


2. 6. 7. 4 Location of the Shear Center 

The location of the shear center is determined using the moment equi- 
librium equation and the shear stress distribution within the tip cross 
section. The applied tip load is assumed to act through the shear center 
of the cross section so that the beam will not twist (Figure 2.6-10). From 
the definition of the stresses (Equation 2.6-98 and 2.6-99), it can be seen 
that the St. Venant torsion function, will be uncoupled from the bending 
problem. 

X Coordinate of the Shear Center 

In order to determine the x coordinate of the shear center, the St. 
Venant functions must be calculated for the case of an applied load acting 
through the shear center and parallel to the y axis, Vy. 

The variation of the total potential energy, 511, for this load 
condition is defined as: 


2 

® - g jzd^lj [k*{*.x + my ) + **,y{*.y + 5<» 2 - x2) } - y(1+<,) dA 

L XXJ /./a 


(2.6-108) 


The element matrices are derived by substituting the Interpolation 
functions (Equations 2.6-105 and 2.6-106) into the variation and carrying 
out the integration over the element area. Writing the matrix relations 
for the m^h finite element by setting the above variation equal to zero: 

[ « = { pm } (2.6-109) 
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where : 


r r 

[ K m ] • “(S- 1 .f 2 ),x N (J 1 ^2 ) ,x * dA ” ( 2 - 6 - 110a ) 


{ pm } = I : N(^ 2 ), x M - " x2) ) + N ^l^2 } { y(1 + u) } dA,r 

(2.6-110b) 


"A m 


The solution of Equation (2.6-109) is the St. Venant bending function 
for a load applied through the shear center In the y direction. The shear 
stress distribution of the cross section is determined by substituting the 
calculated function into Equation (2.6-99). The shear center offset in the 
x direction is calculated by carrying out the moment equilibrium equation 
for the tip cross section using the shear stress distribution. 



( 2 . 6 - 111 ) 


Y Coordinate of the Shear Center 

The y coordinate of the shear center is determined using the same 
procedure as above except a tip load is applied through the shear center 
and parallel to the x axis. The element matrices will have the form: 



J A 


r x^^l'^2^ ,x + N^l'^2^ ,y^^l'^2^ ,y dA (2.6-112a) 



-N(fi,S 2 ) {vxy} - N( fl .f 2 ) {f(x 2 

JJ A ™ 


- y 2 )} + N(£ lr £ 2 ){x(l + t/)}dA m 


(2.6-112b) 
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Once the St. Venant distribution Is known for an applied load through 
the shear center In the x direction, then the stress distribution over the 
cross section can be calculated. The shear center offset In the y 
direction Is calculated by carrying out the moment equilibrium equation for 
the tip cross section: 


*s 



(2.6-113) 


2. 6. 7. 5 Determination of the Torsional Constant 
and the Warping Constants 

The torsional constant, J, and the warping constants are determined 
using the St. Venant torsion function and the finite element method. The 
distribution of this function Is calculated by applying a tip torsion load 
to the cantilever beam. 

The variation of the total potential energy with respect to the St. 
Venant torsion function for a cantilever beam with an applied tip moment 
is: 

sn = L G 0 2 JJ ^ iX ty fX - y} + + x} dA (2.6-114) 

A 


The element matrices are derived by substituting the Interpolation 
functions (Equations 2.6-105 and 2.6-106) into the variation and carrying 
out the Integration over the element area. Writing the matrix relations 
for the m^h finite element by setting the above variation equal to zero: 

[ = {F m } (2.6-115) 

where: 


[ K 1 "] ' N(fi.f 2 ), x N( f i.J 2 ) x + N( fl ,J 2 )_ y N( fl ,J 2 ) tJ , dA 1 " (2.6-116a) 


IJ A m 
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(2.6-1165) 


Once the St. Venant torsion function Is known, the torsion constant, 
J, Is directly calculated based on Its definition. 



(2.6-117) 


The warping constants, which are required for the beam analysis, are 
calculated using the St. Venant torsion warping function distribution, 
f(x,y), and by expressing the cross section Integrals as a summation of the 
Integrals over each finite element (l.e., similar to Equation 2.6-117). 

2. 6. 7. 6 Sample Calculations 

In order to demonstrate the versatility and accuracy of the approxi- 
mate analysis, five example problems are presented. Two problems for which 
known exact solutions are available were selected so that a comparison 
could be made. Three problems of cross sections from an SR-3 turbo-propel- 
ler are also selected. 

The results of an analysis of a rectangular cross section show excel- 
lent agreement between the exact solution and the approximate solution 
(Figure 2.6-11) using 64 finite elements. The calculated warping constants 
were negligible compared to the other constants of the cross section, and 
could be neglected. The calculation of the shear center location for an L- 
sectlon (Figure 2.6-12) shows excellent agreement for a relatively few 
number of elements (36 elements). 

An analysis of cross sections from an SR-3 propeller was also done. 
Three of the cross sections will be discussed here. The first section was 
located at a point roughly 25% from the blade root (Figure 2.6-13). From 
Figure 2.6-13a, It can be seen that there is a significant offset between 
the shear center, mass center, and the chord line. The warping constants, 
which were considered negligible in previous beam developments (Ref. 

2.6-35 and 2.6-36), are of significant magnitude and cannot be neglected 


01-168-86 


2-303 



y 



J = 3.12 in.4 



B) WARPING FUNCTION DISTRIBUTION (CONTOUR LINES OF CONSTANT VALUES OF 0) 


Figure 2.6-11. Analysis of an Isotropic, Rectangular Cross Section 
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Figure 2.6-12. L-Shaped Cross Section 
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Figure 2.6-13a. Profile of SR-3 Turbo-Propeller at Location 25% from Hub 



(Figure 2.6-13b). This Is a result of; (1) the camber in the cross section 
which shifts the St. Venant warping function distribution and the shear 
center away from the mean chord line, and (2) the antisymmetric nature of 
the warping function coupling with the asymmetries of the cross section. A 
cross section from the root of the blade (Figure 2.6-14a) and also from the 
tip of the blade (Figure 2.6-14b) were also analyzed. From these figures, 

It can be seen that the use of camber has a tendency to shift the shear 
center above the camber line and the mass center below the camber line. 

This is expected based on exact results of shear center calculations for 
thin arcs. It is also Important to note that all of the warping constants 
are of significant magnitude and should not be neglected. 

2.6.8 Numerical Results 

Numerical results, aimed at illustrating the characteristics and 
behavior of the nonlinear rotating beam finite element model, will be 
presented. This includes comparisons of linear and nonlinear, static and 
dynamic results with known analytical and experimental solutions. 

Sample Calculations 

Part of the initial verification of this model was to test its ability 
to analyze curved beams. An analysis of a tip-loaded circular cantilever 
beam was done using the present finite element model, Figure 2.6-15. A 
series of tests was performed for different radii of curvature and the 
solutions were compared with known analytical results (Ref. 2.6-37). The 
beam finite element model consisted of six finite elements that were placed 
along the curved elastic axis of the beam. Six different tip loads (l.e., 
three tip forces, three tip moments) were applied separately to the model 
and the tip displacements were calculated for fixed values of beam 
curvature. Excellent results (Figures 2.6-16 through 2.6-18) were obtained 
as the curvature of the beam varied from zero degrees (straight cantilever 
beam) to 90 degrees (semicircular cantilever beam). 

The calculation of the natural frequencies and mode shapes of a curved 
beam was performed and a comparison was made with known analytical 
solutions (Ref. 2.6-38). This part of the verification of the model was 
more difficult because even though there are plenty of results for straight 
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Figure 2.6-14a. Profile of SR-3 Turbo-Propeller at Blade Root 
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Figure 2.6-14b. Profile of SR-3 Turbo-Propeller at Blade Tip 
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A) DESCRIPTION OF CURVED BEAM 


y 





B) FINITE ELEMENT REPRESENTATION (6 ELEMENTS) 

Figure 2.6-15. Tip-Loaded Analysis of Curved Cantilever Beam 
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Figure 2.6-16. Tip Displacements for Tip-Loaded Curved Cantilever Beam 
Applied axial force (top) and In-plane transverse shear 
force (bottom) . 
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Figure 2.6-17. Tip Displacements for Tip-Loaded Curved Cantilever Beam. 

Applied out-of-plane transverse force (top) and torsion 
moment (bottom) . 
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Figure 2 




6-18. Tip Displacements for Tip-Loaded Curved Cantilever Beam. 
Applied out-of-plane bending moment (top) and in-plane 
bending moment (bottom). 
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beams, there are very few closed form results that exist for curved beams. 
This Is because the mode shapes for curved beams are geometrically coupled 
together and their definition is usually described In either two- or three- 
dimensions. 

The natural frequencies and mode shapes for a straight cantilever beam 
were calculated, using six finite elements, and a comparison was made with 
analytical results (Ref. 2.6-38, p. 108). Excellent agreement was obtained 
for the first 11 mode shapes and frequencies, errors of less than 0.5% were 
found between the analytical solution and the present model. 

The natural frequencies and mode shapes of a clamped-clamped semi- 
circular arc were calculated and the solutions were compared with analytic- 
al results (Ref. 2.6-38, p. 207-208), see Figure 2.6-19. Six finite 
elements were placed along the curved elastic axis of the beam and the 
first eight eigenvalues and eigenvectors were determined. These mode 
shapes were compared with the analytical solutions for the in-plane 
flexural modes and the first out-of-plane flexure mode. From Figure 
2.6-19, It can be observed that a good correlation between the finite 
element model and the analytical solution was obtained for very few finite 
elements. A comparison of the torsion modes and the higher order out-of- 
plane flexural modes could not be done because an analytical solution could 
not be found. 

A study was also done to see how the natural frequencies and mode 
shapes of a cantilever beam would vary as In-plane, out-of-plane, and 
pretwisted curvatures were Introduced. The definition of the geometry of 
the beam and the results are presented In Figures 2.6-20 through 2.6-22. A 
series of analyses were performed by starting with a straight cantilever 
beam and Increasing the In-plane curvature (Figure 2.6-20). The results of 
this study show that Introducing in-plane curvature will cause a slight 
reduction in the natural frequencies of the out-of-plane modes (z 
direction) over the complete range of curvatures. This can be accounted 
for by noting that as curvature is introduced Into the beam, the beam is 
actually becoming shorter (in the x direction) and the mass effects are no 
longer evenly distributed, but are concentrated closer to the tip. This 
shortening of the beam and shifting of the mass center of the beam will 
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MODE DESCRIPTION 

PRESENT 

THEORY 

EIGENVALUE (Hz) 

REFERENCE 

2.6-38 

EIGENVALUE (Hz) 

ERROR (%) 

FIRST OUT-OF-PLANE FLEXURE 

472,21 

473.2 

0.21 

SECOND OUT-OF-PLANE FLEXURE 

1343.8 



FIRST IN-PLANE FLEXURE (HOOP) 

2237.26 

2277.5 

1.8 

SECOND IN-PLANE FLEXURE 

2494.7 

2542.5 

1.9 

FIRST TORSION 

2578.3 



THIRD OUT-OF-PLANE FLEXURE 

2716.2 



FOURTH OUT-OF-PLANE FLEXURE 

4537.6 



SECOND TORSION 

4953.6 




B) COMPARISON OF PRESENT THEORY WITH PREVIOUS CLOSED FORM SOLUTIONS 

REFERENCE 2.6-38 

Figure 2.6-19. Natural Frequency Calculation of a Clamped-Clamped 
Circular Arc 
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A) DESCRIPTION OF CANTILEVER BEAM WITH IN-PUNE CURVATURE 




B) NATURAL FREQUENCY OF CANTILEVER BEAM 


Figure 2.6-20. Natural Frequency Calculation of a Cantilever Beam with 
In-Plane Curvature 
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lower the natural frequencies of the out-of-plane modes. A sharp Increase 
In the first torsion natural frequency and a sharp decrease In the third z 
natural frequency In the region of high in-plane curvatures can be 
accounted for due to the geometric coupling. 

The Introduction of out-of-plane curvature Into the cantilever beam 
model will produce effects that are very similar to the effects of In-plane 
curvature, Figure 2.6-21. Out-of-plane curvature will generally lower both 
the in-plane and out-of-plane natural frequencies of the beam because of 
the geometric shortening and shifting of the mass center that Is taking 
place. The natural frequency for the first torsion mode makes a sharp 
increase as out-of-plane curvature is added to this model, due to the geo- 
metric coupling between the torsion mode and the in-plane motion. 

The Incorporation of a uniform distribution of pretwist along the beam 
length will cause the In-plane and out-of-plane natural frequencies to 
coalesce, Figure 2.6-22. This can be accounted for due to the geometric 
coupling that Is Introduced between the In-plane and out-of-plane degrees 
of freedom. The first torsion natural frequency also decreases due to the 
incorporation of beam pretwist that reduces the torsional stiffness of the 
model . 

The nonlinear terms associated with the moderate deflection theory 
were verified using experimental results that were obtained by loading a 
straight cantilever beam In the moderate deflection regime, Figure 2.6-23. 
The results of the calculations using this finite element model were Iden- 
tical to the results produced by Rosen and Friedmann (Refs. 2.6-3 and 
2.6-39). This was expected because when the effects of beam pretwist and 
curvature are neglected, the equations developed by the present theory will 
reduce to the equations of Rosen and Friedmann (Ref. 2.6-3). One of the 
figures from their paper has been Included to show how this theory compares 
with the other theories. From Figure 2.6-23b, It can be observed that the 
present theory follows the experimental results very closely In nonlinear 
range, whereas the linear theory falls away and theory developed by Hodges 
and Dowell (Ref. 2.6-2) appears to be unstable. Further discussion of the 
comparison between the different theories can be found in Reference 2.6-39. 
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MATERIAL: ALUMINIM 6061-T6 



A) DESCRIPTION OF CANTILEVER BEAM WITH OUT-OF-PLANE CURVATURE 



B) NEURAL FREQUENCIES OF CANTILEVER BEAM 

Figure 2.6-21. Natural Frequency Calculation of a Cantilever Beam with 
Out-of-Plane Curvature 
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MATERIAL: ALUMINIM 6061-T6 
NUMBER OF ELEMENTS: 6 




B) NATURAL FREQUENCIES OF CANTILEVER BEAM 

Figure 2.6-22. Natural Frequency Calculation of Pretwisted Cantilever Beam 
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A) DESCRIPTION OF CANTILEVER BEAM 
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B) TIP DEFLECTIONS OF THE BEAM 


Figure 2.6-23. Uniform Cantilevered Beam Under Transverse Loading 
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2.6.9 General Description of Program Structure 

The nonlinear beam structural dynamic analysis program uses a 
conventional structure found In most finite element programs. There Is an 
Initial subroutine "main" which Is used to allocate blank common storage 
and pass the blank common to "smaln" (sub-main). The subroutine "smaln" Is 
the driver for the entire program. Space for all of the Input data, 
generated element matrices, global matrices, and solution arrays Is 
allocated In "smain" using both the blank common and out-of-core storage. 
The linear element matrices (nxn) are generated only once and written to 
out-of-core storage so that they can be used for each Iteration of the 
nonlinear solution. The global matrices are all generated in skew form 
(#dof, bandwidth) and written to out-of-core storage. An out-of-core 
equation solver and an out-of-core eigenvalue package are used to calculate 
the nonlinear static equilibrium position and the eigenvalues, 
respectively. The out-of-core eigenvalue solver package was developed by 
Dr. Gupta of NASA-Dryden and Is available through COSMIC. 

Many of the subroutines that are included In this version of the code 
are not being used If a beam-type analysis Is being done. These subrou- 
tines are going to be used for doing a nonlinear structural dynamic analy- 
sis of rotating advanced composite propellers with plate-type finite 
elements . The plate-type routines that are In the code now, Include all of 
the propeller coordinate generation routines, the plate material properties 
routines (Including composite cross sections with Isotropic and orthotropic 
materials), the plate element routines, the input plate pressure load rou- 
tines, boundary condition routines, and a bandwidth minlmlzer. The Incor- 
poration of a bandwidth minlmlzer is an absolute necessity when designing a 
two-dimensional finite element program because of the limited computer 
storage that can not be wasted by Inefficient node numbering. A flowchart 
of the program Is presented in Figure 2.6-24. 
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Figure 2.6-24. 


Flowchart of Nonlinear Structural Dynamic Analysis 
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Figure 2.6-24. 


Flowchart of Nonlinear Structural Dynamic Analysis 
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3. GAPAS SYSTEM 


This section describes terms and definitions necessary for a user to 
use the Generalized Advanced Propeller Analysis System. It explains how 
the GAPAS executive system is designed, how data handling requirements are 
implemented, and how the user controls the program flow. Once the user 
becomes familiar with the basic concepts of the system, he can refer to 
subsequent sections for the control statements and functional modules 
needed to solve his problem. 

3.1 SYSTEM DESIGN 

The functional design requirements for GAPAS are defined as: 

(1) Flexibility for addition, replacement, or removal of analysis 
modules. This conforms to the modularity requirement necessary 
for the maintenance of large software. 

(2) User control for the selective and effective use of the various 
methodologies. Either single pass or multiple pass, or logical 
bypass of redundant calculations can be implemented with ease. 

GAPAS meets these requirements by separating the overall system into 
two distinct parts; the executive and functional program segments. All 
executive system control tasks are performed in executive modules; and all 
performance analysis is contained in the functional modules. Such a 
modular structure of GAPAS provides the desired flexibility for adding and 
replacing functional modules. 

The GAPAS executive system, which is derived from the NASA Langley 
Aircraft Noise Prediction Program (ANOPP) , allows the user to execute 
either the single-pass or multiple-pass modes. To do that, the user 
prepares a set of GAPAS input control statements which determine the 
processing flow during a run. Using various control statements, the user 
selects the analysis modules, and accesses or creates data units in the 
data base required for the execution of each module. 

The executive system provides for all interfacing with the host 
computer's operating system. It initializes the program, edits the control 
statements, processes each control statement by calling the executive 
and/or functional module into execution, and performs error handling. It 
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also performs data base management within the central memory. It manages 
the global dynamic storage (GDS) , a permanent area established within the 
program field length, where data structures and internal tables are 
maintained. It also manages the local dynamic storage (LDS), where 
intramodule data transfer may be accomplished. 

A functional module is a logically independent group of subprograms 
that perform a specific analysis function, for example, the airfoil loading 
or structural module. A functional module is loaded into central memory 
for execution when the executive system processes a user control statement 
requesting its execution. Upon completion, other executive or functional 
modules may be loaded to process, depending on subsequent control 
statements. 

The functional module internally satisfies its input data requirements 
by referencing the named data unit and data member, or user parameters 
maintained in the data base. Prior to the control statement that requests 
the execution of a particular functional module, the user includes other 
control statements (for example, UPDATE, LOAD) which create the required 
named data units. The data units may have been created in a previously 
executed functional module in the same run, and therefore already exist in 
the run environment. In that case, no further control statements are 
required to establish such named data units. For user parameter, control 
statement PARAM can be used. These control statements are described in a 
separate section. 

3.2 GAPAS DATA BASE 

With the exception of user parameters, all data units within a GAPAS 
run reside within the data base on random access devices such as disks. 

The data base provides a method of storing and retrieving data. In 
addition, through the convention of named data units and members, and the 
capabilities of the data base manager, the user is relieved of the 
responsibilities of interfacing with the host operating system when 
opening, reading, writing, and closing external files. In that, all 
external files, with the exception of the input and output files, are 
dynamically created as a GAPAS run proceeds. 


01-168-86 


3-2 


A data unit is a named collection of data members. It is equivalent 
to a random access file in the external host operating system. A data 
member consists of one or more of logically related and organized records. 
Each member resides on a named data unit and must possess a name unique to 
all members within the same unit. Since no two data units may have the 
same name within a GAPAS run, any combination of data unit name and member 
name uniquely determines the location of data to be fetched. Therefore a 
unit (member) combination provides the address to the data of interest. 

A member consists of one or more records, each conforming to the 
structure specified in the member's format specification. Records are 
arranged in sequential order. The data member supports three general 
format types: 

(1) Unformatted records: variable-length stream of data with 

structure defined for the member. 

(2) Card image records: fixed-length (80 characters) alphanumeric 

records, each with only one element corresponding to a Hollerith 
card image. 

(3) Formatted records: fixed- and variable-length records with their 

structure defined by a member format specification of the 
sequence of data element types for each record. 

In the format specification of a member, the data types of the 
elements within a record are designated by: integer (I); real single 

precision (RS); real double precision (RD); complex single precision (CS); 
logical (L); and alphanumeric string of n characters (An). Member format 
specification rules are discussed in a subsequent section. 

User parameters are considered as part of the overall GAPAS data base. 
They are named data arrays of one or more elements of the same data type. 
The data types of user parameters are designated as those of data members 
discussed above. User parameters are central memory words, and as such 
they can be accessed expediently and conveniently. The values can be 
modified either through subsequent control statements in the same input 
stream, or within functional modules using executive system supplied 
routines . 
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3.3 GAPAS EXECUTIVE SYSTEM CONTROL STATEMENTS 


Control statements are the functional directives by which the user 
controls the flow of a GAPAS run. The statements are all structured in 
accordance with general specifications, and each provides a specific format 
that reflects the functional capabilities provided to the user. Specific 
capabilities provided by control statements Include the following: 

(1) Establishing the beginning and end of the input stream (STARTCS 
and ENDCS) 

(2) Setting the executive system run control parameter (ANOPP) 

(3) Selecting print options for summary information or content of 
data units, members, and user parameters 

(4) Establishing and re-establishing user parameter values 

(5) Establishing conditional processing thereby controlling the flow 
of execution stream (IF GOTO) 

(6) Assigning data units to the run via creation, attachment, or 
loading techniques (UPDATE, LOAD) 

(7) Terminating a data unit's current assignment 

(8) Creating a data unit, data table and data member by using 
existing data currently present in a run 

(9) Executing functional modules 

(10) Establishing the checkpoint and restart capabilities within a 
run. 

3.3.1 Control Statement Format 

Each executive control statement (CS) has a specific format which 
adheres to the conventions described below. 

The CS directive is a free-form sequence of fields on card images, 
using columns 1 through 80. A field is defined as a name or constant 
required for the directive, separated from other fields by a delimiter, for 
example a comma. The field may start from any column as long as the 
sequence of fields specified for a directive is correct. A CS directive is 
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terminated by a "$" sign. The directive may continue on as many as five 
cards If required, and the end-of-data sign "$” only occurs on the last 
card. 


A CS field may not be split across two cards; however, the following 
exceptions are allowed: a complex single precision type field may specify 

one of the two single real constants on one card, and have the second real 
constant entirely on the following card; a string type field, where the 
character value may be split across two cards. 

The general format of a control statement is as follows: 

LABEL, CSNAME, OPERANDS $ COMMENTS 

where: 

LABEL - The label is an optional field specified by one to eight 
characters. It is normally used only in CS which provides conditional 
branching via "GOTO label” control statement. A label is allowed on 
any CS except ANOPP, RSTRT, and STARTCS statements. 

- The specification of on a CS format indicates the 
requirement for a field delimiter. The delimiter may be one or more 
commas or space. 

CSNAME - This is the name of a control statement Identified with one 
to eight characters. The GAPAS executive system supports the 
following control statements: 

ANOPP, ARCHIVE, ATTACH, CALL, CATALOG, CKPNT, CONTINUE CREATE, 
DATA, DETACH, DROP, ENDCS, EVALUATE, EXECUTE, GOTO, IF, LOAD, 
MEMLIST, PARAM, PROCEED, PURGE, RSTRT, SETSYS, STARTCS, TABLE, 
TABLIST, TITLE, UNLOAD, UPDATE, UPLIST 

OPERAND - These are the operand fields required for each control 
statement. 

In the representation of control statements the following additional 
conventions are used: 

(1) Optional fields are always shown enclosed within a set of [ ] 
brackets. 

(2) A field specification where the user has a choice of two or more 
operand types, one of which must be selected, is always shown 
within a set of { } brackets. 


01-168-86 


3-5 


(3) Special delimiter characters are shown where required on control 
statement format specifications. These special delimiters are 
(A) , =, /, nd j . 

3.3.2 Description of GAPAS Control Statements 

The following section describes the syntax and applications of various 
control statements supported by GAPAS. This section is taken directly from 
the ANOPP reference manual and is included in the GAPAS for completeness. 
Therefore any references to ANOPP in the text, for example "ANOPP," "ANOPP 
run" etc., should be regarded as meaning "GAPAS," "GAPAS run," etc. 

3.3.2. 1 ANOPP Control Statement 

PURPOSE : The ANOPP CS allows the user to assign values to specified 

executive initialization parameters and system parameters during the GAPAS 
run. 


Format: AHOPP , pa ram. rvalue. [ • • . • -param =value ] $ 

$1 i i 91 n n 

param the name of an executive system parameter or initialization 

parameter, subject to chanqe via the ANOPP CS, whose value the 
user wishes to replace (see Table 3.3-1) . 

value the value, of the correct data type, which is to replace the 
default value for the specified parameter 

Examples : 

ANOPP JECHO=.TRUE. $ 

ANOPP JLOG= • FALSE* LENGL=3500 $ 

ANOPP NLPPM=4 5 , NOGO=.TRUE., NAEUD=6 $ 

Restrictions : 

The ANOPP CS is valid only as the first CS in the user*s run input 

deck. 


The label field is illegal on the ANOPP control statement. 

Assigned values must be of the correct data type and within the range 
prescribed for the system or initialization parameter. 
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Table 3.3-1. ANOPP CS Initialization and System Parameters 


p«riMt«r 

Description 

value 

Default 

Nan* 

Type 

Type 

Range 

value 

ACCOUNT 

System 4 

Controls accumulation of cost- 
accounting data associated with 
each functional module or execu- 
tive processor 

ACCOUNT-. TRUE. - accumulate 
accounting data 
ACCOUNT-. FALSE. - do not 
accumulate accounting data 

Logical 

.TRUE. 

.FALSE. 

.FALSE. 

CKPNT 

ini tialization 

Identifies external name of check- 
point file to be generated during 
the run. Its specification also 
results in system parameter 
JCKPNT being initialized as 
.TRUE., automatically activating 
checkpoint processing in the run 
(See section 3.10) 

Alphanumeric 
name of 
seven 

characters 
or less 


CPFILE 

JECHO 

System 4 

Controls printing of CS card image 
upon validation in primary edit 
phase (primary input stream 
editing) and secondary edit 
phases (procedure member editing) 

JECHO- .TRUE. - print CS card 
images 

JECHO- .FALSE. - do not print CS 
card images 

Logical 

.TRUE. 

.FALSE. 

.FALSE. 

JLOC 

System 4 

Controls printing of CS card images 
upon execution in executive 
processing phases 

JLOG-.TRUE. - print CS card 

images 

JLOG-. FALSE. - do not print 
CS card images 

Logical 

.TRUE. 

.FALSE. 

.TRUE. 

LENGL 

Initialization 

Controls size (number of computer 
words within user's job field 
length) assigned to global 
dynamic storage (CDS) for this 
ANOPP run 

Integer 

^3000 

12000 

MAXCARDS 

initialization 

Controls maximum number of data 
cards allowed in primary input 
stream following an UPDATE, DATA, 
or TABLE CS 

Integer 


10000 

NAETD 

Initialization 

Controls number of table-directory 
entries initially allocated for 
this ANOPP run 

Integer 


10 

NAEUD 

Initialization 

Controls number of data-unit- 
directory entries initially 
allocated for this ANOPP run 

Integer 

£5 

25 

NLPPN 

Ini tialization 

Controls number of lines per page 
to be used for ANOPP printed 
output during this run 

In teger 

^5 

48 

NOCO 

ini tialization 

Determines if ANOPP run is to be 
limited to primary edit phase 
execution only 

NOGO-.TRUE. - primary edit 
phase only run 

NOGO-. FALSE. - normal ANOPP run 

Logical 

.TRUE. 

.FALSE. 

.FALSE. 


^System parameter values may also be 3et via the SE^SYS CS . 
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3.3.2. 2 STARTCS CS 


\ 

Purpose ; The STARTCS control statement indicates the beginning of the 
user's primary input stream. 

Format : STARTCS $ 

Restrictions : 


STARTCS is valid only when used as the first control statement in the 
primary input stream. A label field is not allowed on the STARTCS. 

A START CS CS may optionally be preceded by an ANOPP CS in the user's 
input deck. 


3. 3. 2. 3 ENDCS CS 

Purpose : The ENDCS control statement indicates the end of the user’s 

primary input stream and terminates the ANOPP run. Special usage of this 
control statement within ANOPP restart runs is documented in section 3.10. 

Format : tlabel^jHTOCS $ 

label label name 

Examples : 

ENDCS $ 

EOJ ENDCS $ 

Restriction : ENDCS is valid only when used as the last control state- 

ment in the primary input stream. 

Examples 

A normal ANOPP run would consist of a primary input stream consisting 
of 


STARTCS $ 

other functional control statements 

m 

ENDCS $ 

The primary input stream may optionally be preceded by an ANOPP CS in 
the user's input deck: 

ANOPP JLOG=. FALSE. $ 

STARTCS S 

ENDCS $ 
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3. 3. 2. 4 SETSYS CS 


Purpose ; The SETSYS control statement allows the user to assign new 
values to specified executive system parameters during an ANOPP run. 


Format ; [label^] S ETSYS^s yspara^ =value,j 1 . • • .^ayspareu^^value^] $ 

label label name 

sysparaa the name of an executive system parameter subject to change via 
the SETSYS CS (see Table 3.3-2) 

value the value of the correct data type which is to replace the old 
value for the specified system parameter 

Examples: 

SETSYS JCON-. FALSE. $ 

LABEL SETSYS JLOG=.TRUE., JECHO.TRUE. $ 


Restriction : Assigned values must be of the correct data type and 

within the range prescribed for the system parameter. 


ORIGINAL PAGE IS 
OF POOR QUALITY 
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Table 3.3-2. SETSYS CS System Parameters 


System 


Value 

Default 

nut 


Type 

H 

Range 

value 

ACCOUNT* 

Controls accumulation of coat* 
accounting data associated with 
each functional module or execu- 
tive processor 

ACCOUNT. TRUE - accumulate 
accounting data 

ACCOUNT* .FALSE. - do not accu- 
mulate accounting data 

logi ca 1 

.TRUE. 

.FALSE. 

.FALSE. 

JCXPNT 

Controls performance of defined 
checkpoint operations during 
sxacution of CXPNT CS 

JCXPNT- .TRUE. - dsfined check- 
point operations will be 
performed during execution 
of s amt CS 

JCXFNT*. FALSE. - no operation 
will be performed during 
execution of a CXPNT CS 

Logical 

•TRUE. 

.FALSE. 

.FALSE. 

(.TRUE, if 
CXPNT 
keyword 
present on 
ANOPP or 
RSTRT) 

JCON 

Determines the foliating executive 
action when the system nonfatal 
error flag is set during 
processing of a control statement 
or functional module 

JCON" . TRUE. - execution will 
continue with processing of 
the next CS 

JCO»* . FALSE. - execution will 
continue with next PROCEED CS 
encountered in the CS stream? 
if none is found, the ENDCS 
will normally terminate the 
ANOPP run 

Logical 

.TRUE. 

.FALSE. 

.FALSE. 

JECHO* 

Controls printing of CS card images 
upon validation in primary edit 
phaae (primary input stream edit- 
ing) and secondary edit phases 
(procedure member editing)? note 
that to affect printing of pri- 
mary CS stream card images, JECHO 
■ust be set to .TRUE, via an 
ANOPP CS (see section 3. 1.3. 2) 

JECWO .TRUE. - print CS card 

images 

JECHC^ . FALSE. - do not print 
CS card images 

Logical 

j 

.TRUE. 

.FALSE. 

.FALSt. 

JLOG* 

Controls printing of CS card images 
upon execution in the executive 
processing phases 

JLOO .TRUE. - print CS card 

images 

JLOC*. FALSE. - do not print CS 

card images 

Logical 

.TRUE. 

.FALSE. 

.TRUE. 

JRS7RT 

Controls action of executive mana- 
ger when ENDCS (simulated if not 
present) is encountered in 
inserted CS stream of a restart 
run 

JRSTRTm .TRUE. - this restart 
run will continue with 
execution of the defined, 
checkpointed CS stream? 
execution will begin with 
the CS following the last 
CXPNT CS processed m the 
checkpoint run 

JRSTRT*. FALSE. - this restart 
run will terminate after 
execution of the ENDCS CS 
in the inserted input streaa 

Logical 

j 

.TRUE. 

.FALSE. 

.FALSE. 

(.TRUE, if 
RSTRT CS 
begins run 
input stream) 

. 


V*rmmmtmT v«lu« uy also be sec via the ANOPP CS . 


OBsGil'JAL PAGE IS 

OF POOR QUALITY 




3*3. 2. 5 TITLE CS 


Purpose : The TITLE control statement sets the value of the title line 

to be printed within the ANOPP standard page header, (See Figure 3.3-1.) 

_F£rmat: tlabel^lTITLE* $ 

label label name 

paranname the valid ANOPP name of a user parameter (defined via a 

PARAM CS) that contains the title line value, which must 
be a string constant not exceeding 128 characters (16A8) 

string constant the title-line Hollerith string value, not to exceed 

128 characters ( 1 28Hxxxx. ♦ • ,x) 


Examples : 


LABEL 1 TITLE 9HJET NOISE $ 

TITLE PARAM1 $ 

Restriction : The title value must not exceed 128 characters and will 

be printed with the left margin justified. 


Line L 
Line 2 
Line 3 
Line 4 
Line 5 


mm/dd/yy ANOPP Lnn/nn/nn PACEnnnn 

Title (128 character maximum) 

Subtitle (128 character maximum) 

Label (128 character maximum) 

blank 

ANOPP page-header contents include: 


mm/dd/yy 

Lnn/nn/nn 

nnnn 

Title 

Subtitle 

Label 


calendar date of ANCPP run 

current release level of ANOPP system 

page count initiated at zero for each run 

title-line value last assigned via a 
TITLE CS; default value * spaces 

subtitle-line value last assigned from 
within a system or functional module 

label-line value last assigned from 
within a system or functional module 


Figure 3.3-1. ANOPP Standard-Page-Header Content 


r ^ 'v' Hi, jTV 
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3. 3. 2. 6 PAEAMCS 


Purpose : Ihe PARAM control statement establishes a new user parame- 
ter's value array of one or more elements, or it changes the value array of 

an already existing user parameter. A parameter's current data type and 

number of array elements is determined by the last value assigned it. 

Fo rmat : 

[label^JPARAM^pname^ =expression 1 [ . .pna®e n =express ion n l $ 

where expression may take any of the following forms: 

pname 9 /P naae 3 ) 
z \integer/ 

+ ] 

} numerical constant 
*1 

/] 

value 

label label name 

pnamej the name of the user parameter for which a value is to be 
established or changed 

pname 2 the name of a previously established user parameter 

pname^ the name of a previously established single-element user parameter 

of integer type 

value an array of one or more elements of type numerical constant (I, RS, 
RD, or CS), logical constant (L), or string constant (A). Array 
elements must be separated by one or more delimiters (comma or 
space) . Examples of each value-type specification are presented 
below. For all variations of a data-type control statement 
specification, see table 1 in section 3.1.2. When the value 
specification is for a multielement Hollerith string-type 
parameter, each string constant must specify the same character 
field length (jiHxx...x) 

numerical constant a numerical constant of type I, RS, RD, or CS 
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In the first form, the current value of an unsubscripted parameter 
pname 2 will be assigned to user parameter pname 1 . If pname 2 has a sub- 
script, then the value of the specified element from the pname 2 array will 
be assigned to the user parameter pname 1 . If pname^ is the subscript, it 
must be of integer type and contain only one element. Otherwise, the sub- 
script must be an integer constant, Pname 2 must contain at least the number 
of elements specified in the subscript. 

In the second form, the specified algebraic operation will be performed 
against each element of this parameter's value array, with the result of 
each operation established in the corresponding element of parameter 
pname 1 's value array. The type of pname^ (I* R S, RD, or CS ) must be the 
same as that of the specified numerical constant. 

When performing an algebraic operation on complex single-precision- type 
(CS) numbers, each CS number is treated as a two-element single-precision 
array (RS, RS). Then, addition, subtraction, multiplication, and division 
of complex numbers will be calculated as follows, with A, B, C, and D each 
being real single-precision numbers: 

{ A, B ) + (C , D) = (A+C,B+D) 

( A , B) - ( C ,D ) * ( A-C , B-D ) 

(A,B)*(C,D) = ( (AC+BD) , (AD+BC) ) 

( A , B) / ( C ,D ) =* ( { (AC+BD)/(C**2+D**2) ), ( ( BC-AD) / ( C* *2+D* *2 ) ) ) 

Examples: 

The following establishes real double-precision- type parameter L 
(1 element) and integer-type parameters G (1 element) and C (1 element): 

PARAM L=1,5D-2, G=1 234, C = 2 $ 

The following establishes string-constant- type user parameter KEYS 
(3 elements): 

LABEL 1 PARAM KEYS= 5 4HFAN 4HJET 4HPR0P $ 

The following establishes logical parameter RESULTS (2 elements): 

PARAM RESULTS- * TRUE , .FALSE. $ 

The following establishes integer- type parameter NUMBS (2 elements) and 
real double-precision-type parameter STATS (2 elements): 

PARAM NUMBS=3476 5962, STATS=1 7 .67D27 -1.D+194 $ 

The following establishes complex single-precision-type parameter 
AGROUP (2 elements) : 

PARAM AGR0UP=(7. ,1 77E+1 7) (265.1 7E+2 -1.75) $ 
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The following establishes real double-precis ion- type parameter T by 
using an algebraic operation based on the current value of parameter L? 
establishes integer-type parameter A with the value of current parameter G; 
and establishes real double-precision parameter B based on the current value 
of parameter T (note that the add operator + is followed by spaces) : 

PARAM T=L*1 7 .620-07, A*G, B*T + 2.0D00 $ 

The following assigns the third element of parameter KEYS to parameter 
E and the Cth element of parameter KEYS to parameter D: 

PARAM E=KEYS ( 3 ) , D»KEYS(C) $ 

Restrictions : 

The numerical constant used in a PARAM CS specified algebraic operation 
must be of the same numerical type as the specified user parameter (pname 2 ) 
used in that operation. 

The operators + or - must be followed by a blank. 

Each value specified for a multielement user-parameter array must be of 
the same type. 

Each value specified for a multielement Hollerith string parameter must 
be of the same character length (_nHxx...x). 

For a subscripted parameter name, that parameter must contain at least 
the number of elements specified within the parentheses. If the subscript 
(value inside the parentheses) is a parameter name, it must be of integer 
type and contain only one element. 


3. 3. 2. 7 EVALUATE CS 


Purpose : The EVALUATE CS establishes a new user parameter of one ele- 

ment or changes the value of an existing user parameter element. 

EVALUATE^parM-exp $ 

where param-exp may take any of the following forms: 

pname^ =* expression 

pnaae 9 f pname 3 \ = expression 
z ^integer/ 

label label name 

pname<| the name of the user parameter for which a value is to be 
established or changed. The value assigned to pname^ is 
the result of the evaluated expression. The type assigned to 
pname 1 is the type associated with the expression. 
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PM»«2 t}le name a previously established user parameter whose specified 
element will be changed to the result of the evaluated expres- 
sion, If pname^ is the subscript, it must be of integer type 
and contain only one element. Otherwise, the subscript must be 
an integer constant. Pname 2 must contain at least the number 
of elements specified in the subscript. The type associated with 
the expression must match the type associated with pname 2 . 

p name 3 the name of a previously established single-element user parameter 

of integer type 

expression a sequence of constants, user parameters, subscripted user 

parameters, and function references separated by operators 
and parentheses 

The arithmetic operators are as follows: 

+ addition 

subtraction 
* multiplication 

/ division 

** exponentiation 

The following functions are available: 


Name 

Definition 

Number of 
arguments 

Type of 
arguments 

Example 

ABS 

|X| 

1 

Any type 

Y=ABS ( X ) 

ANTILOG 

10 X 

1 

I , RS , RD 

Y=ANTILOG ( X ) 

COS 

cos(X) 

1 

Any type 

Y=COS ( X ) with 
X in deg 

INT 

Express argument as 
integer 

1 

Any type 

Y=INT(X) 

LOG 

log 10 (X) where 
X > 0 

, 

1 

I , RS , RD 

Y=LOG( X ) 

REAL 

Express argument 
as real 

1 

Any type 

Y=REAL( X ) 

SIN 

sin(X) 

1 

Any type 

Y=SIN(X) with 
X in deg 

SQRT 

{x where X > 0 

1 

Any type 

Y=SQRT( X) 

TAN 

sin( X) /cos( X) 

1 

Any type 

Y=TAN(X) with 
X in deg 
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All operations must be specified explicitly. For example, to multiply 
two variables A and B, the expression A*B must be used. Thus, AB, (A) (B) , 
or A.B will result in a syntax error with the exception of AB which is 
treated as a parameter name. 

An expression is comprised of subexpressions. In the example 
A/B - C # D**E 

the following are subexpressions: 


(1) 

A/B 



(2) 

D**E 



(3) 

C* temp-j 

(where temp 1 

= D**E) 

(4) 

temp^ - temp 2 

(where temp 2 = C*(D**E) and temp 3 

= A/B) 


The sequence in which an expression is evaluated is governed by the 
following rules which are listed in descending precedence: 

(1) Subexpressions delimited by parentheses are evaluated, beginning 

with the innermost subexpressions. 

(2) Subexpressions defined by arithmetic operators are evaluated 

according to the following precedence hierarchy: 

** exponentiation 

/ * division or multiplication 

+ - addition or subtraction 

(3) Subexpressions containing operators of equal precedence (+ and - 

or * and /) are evaluated from left to right. 

(4) Subexpressions containing the exponentiation operator {**) are 

evaluated from right to left. 

In exponentiation, the following types of base and exponent are 
permitted: 


Base 

Exponent 

Integer 

Real 

Double precision 

Complex 

In teger 

Integer, real, and double precision 
Integer, real, and double precision 
Integer 


The exponentiation is evaluated from right to left. The expression A**B**C 
is evaluated as (A**(B**C)). 
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A subexpression in a given level is evaluated at the highest type 
(CS RD RS I) of any parameter or constant in that subexpression. In expo- 
nentiation both the base and exponent are converted to the highest type in 
the subexpression with the exception of a complex base. For a complex base, 
any noninteger- type exponent is converted to an integer type. The type of 
the expression is the type associated with the last subexpression evaluated. 

Examples : 

Given the following parameter values, the expression to the left of the 
equal sign on the EVALUATE CS is evaluated and the result, 43.24, is stored 
in the user parameter table (UPT) under parameter X: 

PARAM BAD=16.3, BC=5.3, CD=.96 $ 

PAR AM DE= • 3 , EF=2.0, F=3 $ 

EVALUATE X =* (BAD - BC) *F + (CD/DE) **EF $ 

The following results in the parameter 2 taking the value 3.5 in the 

UPT: 


EVALUATE Z = SIN(30.0) + REAL( 3 ) $ 

Given the following parameter values, the following operations are per- 
formed. The square root of 100.0 is taken, converted to an integer, and 
then is added to the negative value of Z. The result, 6.5, is stored as the 
Ith, or 2nd, element of the parameter Y. The value of the expression must 
have the same type as Y: 

PARAM Y= 1 0.0, 3.9, 8.2, I=*2 $ 

EVALUATE Y(I) =* -Z + INT( SQRT( 1 00 .0) ) $ 

Restrictions : 

The operators + and - must be followed by a blank. For a subscripted 
parameter, that parameter must contain at least the number of elements spec- 
ified within the parentheses. 

If a multielement nonsubscripted parameter is in the expression, only 
the first element is used. 

Each left parenthesis must have a corresponding right parenthesis. 

The type associated with the expression must match the type associated 
with the parameter to the left of the equal sign if that parameter is a 
subscripted parameter. 


3. 3. 2. 8 UPLIST CS 

Purpose : The UPLIST control statement will produce a printed list of 

all user parameters currently defined within the ANCPP run. The list 
includes each user parameter array's name, the alpha data type, internal 
ANOPP numeric data-type code, and the number and value of each element in 
the array. 
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label 


Format ; label^UPLIST $ 
label name 
Example : 

The following control statement 
LABEL1 UPLIST $ 

if executed when the user parameters established in a run were those created 
by the PARAM CS examples and EVALUATE CS examples presented in the two pre- 
vious sections , would produce the following listing: 


USER- PARAMETER- TABLE DUMP 


NAME 

TYPE* 

TYPE 

CODE 

ELEMENT 

VALUE 

AGROUP 

CS 

4 

( 

1) 

.70000000000000E+01 .1 7700000000000E+20 




( 

2) 

• 265 1 700000000 0E+0 5 - . 1 7500000000000E+0 1 

A 

I 

1 

( 

1) 

1234 

B 

RD 

3 

( 

1) 

•2 0000000264 299999999999999999D+ 01 

BAD 

RS 

2 

( 

1) 

.1 6300000000000E+02 

BC 

RS 

2 

( 

1) 

.5 3000000000000E+01 

C 

I 

1 

( 

1 ) 

2 

CD 

RS 

2 

( 

1) 

•96000000000000E+00 

D 

A 

-4 

( 

1) 

JET 

DE 

RS 

2 

( 

1) 

. 3 0000000000000E+ 00 

E 

A 

-4 

( 

1) 

PROP 

EF 

RS 

2 

( 

1) 

•20000000000000E+01 

F 

I 

1 

( 

1) 

3 

G 

I 

1 

( 

1) 

1234 

I 

I 

1 

( 

1) 

2 

KEYS 

A 

-4 

( 

1) 

FAN 




( 

2) 

JET 




( 

3) 

PROP 

L 

RD 

3 

( 

1) 

. 1 499999999999999999999999999 9D-0 1 

NUMBS 

I 

1 

( 

1) 

3476 




( 

2) 

5962 

RESULTS 

L 

6 

( 

1) 

T 




{ 

2) 

F 

STATS 

RD 

3 

{ 

1 ) 

.1 766999999999999999999999999 8D+ 2 9 




( 

2) 

-.99999999999999999999999999975+1 94 

T 

RD 

3 

( 

1) 

.2 64 299999999999999999999999 89D-0 7 

X 

RS 

2 

{ 

1) 

.43 240000000000E+02 

Y 

RS 

2 

( 

1) 

.1 0000000000000E+02 




( 

2) 

.65000000000000E+01 




( 

3) 

. 8200000000000 0E+01 

Z 

RS 

2 

( 

1) 

.35000000000000E+01 


TYPE CODE is an integer internal-sys tem- type code* Of interest to the external ANOPP 
user is the TYPE CODE for type A (Holerith string), expressed as a negative n value, where 
n is the uniform character length of the string for elements of the user parameter array. 


Restrictions: None. 
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3. 3. 2.9 EXECUTE CS 


Purpose : The EXECUTE control statement calls a specified functional 

module (FM) into execution and allows the user to identify alternate data 
items to be used in satisfying specific data requirements of the functional 
module . 

Fo rmat : 

[lately] KXECOTE J jfana»e^[refnaae 1 *altnaae 1 ... .^ref naae n *altna»e n ] $ 
label label name 

fmname the name of a functional module to be executed. 


ref name the name known within the functional module for a required data 

unit, data member, table member, or user parameter. It is also 
the name by which the data item is identified in the section 4 
documentation of the FM's data requirements. 

altname the altname name corresponding to the FM known ref name. The 

altname is the name of a data unit, data member, table member, 
or user parameter to be used in satisfying the requirement for 
a data item known within the FM by the ref name. 

Examples : 

LI EXECUTE JET UNITI *MYUNIT, B=D $ 

EXECUTE PROP $ 

Restrictions : 

The fmname must be a functional module currently installed on the ANOPP 
system. 

User-supplied data items must be of the type and format specified for 
the FM application. 


Examples 

The following examples illustrate typical control statements required 
to satisfy FM data requirements. Functional documentation of the various 
control statements used are found in other subsections of this manual. 

Example 1 : The FM JET1 is to be executed. It requires a logical user 

parameter JSELECT, a real single-precision user parameter NSPEED with three 
elements, and data unit JETUNIT on which reside members TAB1, TAB2, DMEM1 , 
and DMEM2 • No substitute data items are to be used? once established in the 
run, all required items will be accessible by the FM. 
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STARTCS $ 


ATTACH JETUNIT/FILE29/ $ COMMENT - ESTABLISH JETUNIT IN RUN 
PARAM JS ELECT-. TRUE., NSPEED-1 .33E05 -0.52 19.7 $ 

EXECUTE JET1 $ 

ENDCS $ 

Example 2 : Execute FM MACH8 . Build a required data member identified 

in FM documentation as UNIT1 (STATJ) via the CREATE CS and UPDATE CS. Func- 
tional module MACH8 creates a logical user parameter documented as RESULT. 
Because the user has already created a parameter named RESULT earlier in the 
for a different purpose, an alternate name specification is used to 
cause the FM-created user parameter to be called M8RESULT. 

STARTCS $ 

• 

CREATE UNIT1 $ 

UPDATE NEWU-UNIT1 SOURCE 25 * $ 

-ADDR 0LDM=s* , NEWM^STATJ FORMAT^ 1 1 H2 1 , RS , RD , L$ MNR=2 $ 

1757 294372 2E+01 30-01 .FALSE • $ 

297 87536 375.1 5E-12 15.81D19 .TRUE. $ 

END* $ 

EXECUTE MACH8 RESULT=*M8RESULT $ 

3.3.2*10 ATTACH CS 

Purpos e : Tlie ATTACH control statement establishes one or more previ- 

ously created data units in an ANOPP run via entries in the system data unit 
directory (DUD) • Each data unit must have previously been created on an 
external mass-storage file currently assigned to the job in the external 
system. 

Format : 1 1 abe 1^ ] ATTACH^du /e f / [ . . .^ur^/e f i^/] $ 

' label label name 

dun the name of the data unit to be established in the ANOPF run 

/efn/ the name of the external mass-storage file, currently assigned to 

the user's job, -on which data unit dun resides 

Examples: 

APP ATTACH JETU1 /FILEJ/, FANU1 /FILEF/ $ 

ATTACH PR0PU1/EFN/ $ 

Restrictions : 

Each data unit name (dun) must be unique with respect to all other data 
unit names currently known in the run. 

Each external file name (efn) must be unique with respect to all other 
efn's currently known in the run. 
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Each data unit (dun) specified must have previously appeared on a 
DETACH CS. 

If the data unit was created in a previous ANOPP job, the external file 
(efn) it resides on must be currently assigned to this job via external 
control cards. 


3.3.2.11 CREATE CS 


Purpose : The CREATE control statement initially defines in the ANOPP 

run an empty data unit, to reside on a random-access mass-storage device, 
and makes it available for subsequently generated table, data, and procedure 
members . 


Fo rma t ; [label^JCREAT^duit, [/efo,/] [/efn,,/]] $ 

label label name 

dun the name of the new data unit to be entered in the system data unit 

directory whose members are to be generated during the run 

/efn/ the name of the external mass-storage file, assigned to the job in 
the external system, on which the corresponding dun will reside. 
If efn is omitted, a scratch (temporary) file will be established 
by the ANOPP system. 

Examples : 

LABEL 1 CREATE UNIT! , UNIT2/EFN2/, JETUN1 /JETFILE/ $ 

CREATE J0BFILE1 , J0BFILE2 $ 

Restrictions : 


The dun and efn cannot, respectively, be the same as any other dun and 
efn that are either currently known to the ANOPP run (entered in the data 
unit directory) or appear on the same CREATE CS. 

Any data that currently reside on external file efn will be destroyed 
during the creation of new data unit dun, even if the old data were on an 
ARCHIVE *d ANOPP data unit. 

Note: Reference to a unit that has not been defined by a CREATE CS during 

an ANOPP run will cause the unit to be dynamically created on a scratch 
file. 


3.3.2.12 DETACH CS 

Purpose: The DETACH control statement removes a data unit from the 

run-life data base. Unless the data unit resides on a scratch (temporary) 
file, it may be assigned to the current or a future ANOPP run via an ATTACH 
control statement. 
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Format: 


[ label^ ] DETACH^durLj [ . . $ 

label label name 

dun name of the data unit, known to the ANOPP run, that is to be 

detached 

Example : 

LI DETACH PR0PU1 , JETU1 $ 

DETACH AIRPRTS $ 

^ es t^iction : Each data unit named must be currently known in the ANOPP 

run (via an entry in the system data unit directory). 


3.3.2.13 PURGE CS 


Purpose: The PURGE control statement removes a data unit from the run 

life data base? in addition, the external file on which the unit resides 
w iil no longer be assigned to the user's job in the external system. 

Format : [label^]PURGE^dun 1 [ . . # . .^dun n J $ 

label label name 

dun name of a data unit whose current run and job assignment is to be 

terminated 

Example : 

LABEL1 PURGE DU1 , DU2, DU3 $ 

PURGE JETU1 $ 

Restriction : If the data unit is to be re-ATTACH'ed in the same job, 

or the external file on which the dun resides is to be made permanent via 
external control cards that follow the ANOPP run (in the user's job deck), 
the DETACH CS should be used instead of the PURGE CS . 


3-22 



X 

5 

J 

3.3.2.14 CATALOG CS 


Purpose : The CATALOG control statement produces printed summary infor- 

mation. about named data units or, optionally, about all data units known to 
the ANOPP run. In addition, an optional FULL report presents summary infor- 
mation about each resident member of each specified unit. 

Format: E 1 ib« 1^ ] CATALOG^ ] M», S 

label label name 

LIST* optional specification allows selection of the type of catalog 

report desired for the specified du's (data units). If omitted, 
LIST* FULL is assumed. 

LIST*SUMMARY: A SUMMARY CATALOG report will be produced for each data 

unit specified, and will include: 

The data unit name 

The name of the external file on which the data unit resides 

The name of each member that resides on the unit 

LIST* TOLL (default) : A FULL CATALOG report will be produced for each 

data unit specified and will include: 

The SUMMARY report of items listed above for each member on the 
data unit: 

The maximum number of records allowed 
The current number of records 
The member (record) format 
The maximum record length 

The date and time of day the member was created 

du (optional) name of a data unit, currently known in the run, about 

which the user wants a CATALOG report of the selected type. If 
omitted, the selected report will be produced for all run-life 
data units, except for system units XSUNIT and XRUNIT (if a 
restart run). The user may specify: XSUNIT and XRUNIT, in a 

checkpoint/restart run. 
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Examples ; 


The following will produce FULL reports on all run-life data base 
units, except for system units XSUNIT and XRUNIT: 

LABEL! CATALOG $ 

The following will produce a SUMMARY report on data unit DUN7 : 

CATALOG DUN7 LIST=SUMMARY $ 

The following will produce FULL reports on all run-life data base units 
except for system units XSUNIT and XRUNIT: 

CATALOG LIST=FULL $ 

The following will produce FULL reports on data units 0UN1 and XSUNIT: 
CATALOG LIST=FULL, DUN1 , XSUNIT $ 

Restr iction : Specified du's (data units) must be currently established 

in the run-life data base. 


3.3.2.15 MEMLIST CS 


Purpose : The MEMLIST control statement produces a printed report about 

specified members residing on run-life data units. The report may option- 
ally be limited to summary information (member structure and unit residence) 
on each of the specified members; or the FULL report can be produced to 
include the summary information plus the listing of values currently stored 
in the specified members' records. 

Format: [lately] MEMLIST^ ember, [ ^emberj $ 

where each specified member^ combination has the form 
du(mn) Qrml ,rn] )] [^FORMAT* format] 
label label name 

LIST** optional keyword allows selection of the type of MEMLIST report 
desired for the specified members. If omitted, LIST=FULL is 
assumed. 

LIS^StMMARY: A SUMMARY report will be produced for each member 

specified and will include: 

The name of the data unit on which the member resides 
The name of the external file on which the member's data unit 
resides 

The name of the member 
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The member's: 

Maximum number of records 
Current number of records 
Format specification 
Maximum record lenqth 
Date of creation 
Time of creation 

LIST* FULL (default): A FULL MEMLIST report will be produced for each 

member specified and will include: 

The SUMMARY information listed above 

The data values of each member record specified by param (rm f rn) 
below, or all member records if (rm,rn) is omitted? printed in 
the format specified by keyword FORMAT* below, or in the format 
under which the member was created if FORMAT* is omitted. 

du(oin) the name of the data unit (member) to be reported on 

the optional specification of the integer sequence number (rut) 
of the record or the range of integer sequence numbers (rm,rn) 
of the records on the member whose values are to be listed. If 
omitted, the values of all the member's records will be dis- 
played. If LIST=SUMMARY, this parameter is ignored. 

FORMAT = optional keyword parameter specifies the member format to be 
used in printing the indicated records. This field is 
ignored if LIST=SUMMARY . 

If omitted , the indicated records will be printed in accordance with 
the format specification under which the member was created via a 
DATA CS, LOAD CS, TABLE CS, or UPDATE CS . Unformatted records are 
always printed in octal format. 

FORMAT* 0 produces an octal printout of the data content of the 

specified records, regardless of the format under which the member 
was created. 

FORMAT* 2HCI indicates that the member has a card-image format; 
each card-image record will be listed on a single print line. 

' FORMAT=specif ied ANOPP format. A valid ANOPP format specification 
produces a printout of records in that format. The specified 
format is assumed to be compatible with the records to be printed 
and is not validated internally. A member (record) format is 
expressed as a character string terminating with a S, as shown 
in the following examples: 

FORMAT* 1 2 H5 ( I ) , A30 , RS$ (fixed length format) 

FORMAT* 1 7HI , 2A1 0 , * ( 1 , 1 ORS ) $ (variable length format) 


(rm) 

or 

(rm,rn) 
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Examples ; 


The following will print a SUMMARY report on data members DMEN1 and 
DMEN2, both resident on data unit DUN1 : 

LABEL 1 MEMLIST LIST-SUMMARY, DUNI(DMENI), DUN1 ( DMEN2 ) $ 

The following will print a FULL report on data member DMEN3 of data 
unit DUN1 • Each record on the member will be listed, and the data values 
will be displayed in octal code. 

MEMLIST LIST-FULL, DUN1 ( DMEN3 ) FORMAT=0 $ 

The following will print a FULL report on data member DM9 of data unit 
DU1 , listing the values of member records 11 and 12 in the format under 
which the data member was created: 

MEMLIST DU1 (DM9) , (11,12) $ 

Restrictions: 

Specified data units and members, du(mn), must be currently assigned to 
the run-life data base. 

Specified member record occurrences, (rm) or (rm,rn), must be valid for 
the member being listed* 


3.3.2.16 TABLIST CS 

Purpose: The TABLIST control statement produces a printed report con- 

taining summary information about the ANOPP data tables that reside on spec- 
ified run-life members. In addition, a FULL TABLIST report may be selected 
that includes the listing of the specified tables' assigned values. 


Format: 


tlab^ljjlTAHLISTj 


v 

^ \S0MMARYJ £ 


du., ( t* 1 ) [ . , 


•A (t "n n 


label label name 

LXS^ optional keyword allows selection of the type of TABLIST report 
desired for the specified member resident tables. If omitted, 
LIST-SUMMARY is assumed. 

LIS^StMMARY (default) : A SUMMARY report will be printed about 

the ANOPP data table that resides on each specified data unit. The 
SUMMARY report includes the following: 

Residence data unit name 
Residence external file name 
Residence table member name 
Creation date 
Creation time of day 
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Number of independent variables 
Length in words 

Allowable interpolation procedures 

LIST^FULL: A FULL TABLIST report will be printed on each specified 

table and will include: 

The SUMMARY report information (above) 

The following data on each independent variable defined for the 
table: 

The type code 

The number of table values 

The procedure for extrapolation beyond the last assigned value 
The assigned values 

and the following data on the dependent variable: 

The type code 

The number of table values 
The assigned values 

du(tm) the run-life data unit name (table member name) on which the data 
table to be reported on resides 

Examples : 

The following will produce a FULL TABLIST report on data unit DUN! 
resident table member DTBL1 : 

LABEL! TABLIST LIST=FULL, DUN! ( DTBL1 ) $ 

The following will produce a SUMMARY report on data unit DUN2 resident 
table member DTBL2 : 

TABLIST LIST*SUMMARY DUN2( DTBL2) $ 

The following will produce a SUMMARY report on data unit DUN! resident 
table members TBL! and TBL2, and on data unit DUN3 resident table member 
TBL1 : 


TABLIST DUN! (TBL1 ) , DUN! ( TBL2) , DUN3 ( TBL! ) $ 

Restrictions : 

The ANOPP table residing on a specified member must have been created 
either via a TABLE CS or internally by a functional module. 

Each specif ied- table residence data unit (table member) must currently 
be assigned to the run. 
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3.3.2. 17 Archiving (ARCHIVE CS) 


The ARCHIVE CS is used to assign a permanent ANOPP read-only status to 
an existing data unit. It is intended for the user who has built a data 
unit and now wants to prevent any possibility of a future change being made 
to the data content of that unit as a result of subsequent TABLE CS, 

UPDATE CS, or functional module processing. The archive (read-only) status, 
once established, is recorded in the internal header of the unit and cannot 
be reversed during the current or any future ANOPP run or job. 

Purpose: The ARCHIVE control statement prohibits any future request to 

write on the named unit or units via TABLE CS, UPDATE CS, or functional 
module processing, whether in the current run or in any subsequent ANOPP run 
or job. 

Format : [label^] ARCHIVE^duiLj [..... .^idui^] $ 

label label name 

dun name of the data unit to be archived 

Examples : 

LAB ARCHIVE UNI, UN2 , UN20 $ 

ARCHIVE, U50 $ 

Restrictions : 

Each unit name must be unique with respect to the other unit name(s) on 
the control statement. 

Each unit to be archived must be currently assigned in the ANOPP run. 

The archive (read-only) status prevents data unit content modification 
via subsequent TABLE CS, UPDATE CS, or functional module processing. It 
does not prevent either the modification of the content of the file via 
subsequent external (non-ANOPP) processing or the creation of a new unit on 
the file via CREATE CS or LOAD CS processing. 

ANOPP system scratch units (a unit whose associated external file name 
begins with the letters "XEFN") may not be archived. 
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3.3.2,18 LOAD CS 


Purpose: The LOAD control statement creates new run-life data units by 

using as a source of data the units and members previously stored on a 
sequential library file via an UNLOAD CS (in either the current or a previ- 
ous ANOPP run) . The specified library file must be currently assigned to 
the user's job in the external system. The LOAD CS provides for selective 
loading and/or renaming of data units and data members stored on the sequen- 
tial library file. 

Format : [label^lLOAD/sefn/td^ , • • • • ,du n ] $ 

where each du^ has the format 

ndu |[/efn/] [-odu] [ , . .mn n l )jj 

where each mn^ has the format 


label label name 

sefn the name of a sequential library file, currently assigned to the 
user's job in the external system, from which stored data unit 
(member) data will be copied 

ndn (optional) the name of a new data unit to be established in the 

run-life data base. If members residing on more than one LF 
stored data unit (odu) are to be copied to the same new ndu, 
repeat specification of this field is required. If no ndu is 
specified, all of the library resident units will be established 
in the run-life data base on scratch files with no change in 
names or data contents. 

/efn/ (optional) the name of the external random access file, assigned to 
the user's job, on which the new data unit will reside. If 
omitted, a scratch (temporary) file will be used for that ndu. 

If more than one LF stored data unit (odu) is to supply members 
for the new du, the /efn/ specified for that new ndu should occur 
only once on the LOAD CS. 

-odu (optional) the name of the library resident data unit whose members 

are to be copied to the new du. If omitted, the library resident 
data unit (odu) and the run-life data unit (ndu) will have the 
s ame name • 

nmn (optional) the name of the member to be created on the ndu. If no 

nmn is specified, all odu members are copied to ndu. 

-01 m (optional) the name of library unit odu resident member to be 

copied to the ndu member nmn. If omitted, the odu resident mem- 
ber (omn) and the run-life member (nmn) will have the same name. 
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Examples; 


The following examples will illustrate the various features of the 
LOAD CS. Each example will use a previously created sequential library file 
named OLDLF , assumed to be currently assigned to the user's job in the 
external system. The OLDLF was created by an UNLOAD CS that stored copies 
of data units UNIT!, UNIT2, UNIT3, and UNIT4? each stored data unit contains 
members MEM1 , MEM2, MEM3, and MEM4. 

Example 1 : The following would result in all four OLDLF stored units 

being established as run-life data units under their stored names with no 
change in their member content. All of the new units would be created on 
scratch (temporary) external files since no efn's were specified. 

LABELA LOAD/OLDLF/ $ 

Example 2 : The following would result in new run-life data unit UNIT3 

being established on external file FILEB. The UNIT3 would contain MEM1 , 
MEM2, MEM3, and MEM4 • 

L0AD/0LDLF/UNIT3/FILEB/ $ 

Example 3 : The following would result in new run-life data unit JETU 

being established on external file FILEC. Unit JETU would contain members 
(MEM1 (a copy of library stored member UNIT4 (MEM1 ) ) and member ALTTBL (a 
renamed copy of library stored member UNIT4 (MEM2) ) • 

LOAD/OLDLF/ JETU/FILEC/*UNIT4 (MEM1 , ALTTBL* MEM2 ) $ 

Example 4 : The following would result in the establishment of new run- 

life data units JU and PU. Unit JU would reside on external file JFILE and 
would be a renamed copy of OLDLF stored unit UNIT1 • Unit PU would reside on 
external file PFILE and contain six members. The PU members MEM1 through 
MEM4 would be exact copies of OLDLF stored unit UNIT2's four members. The 
PU members MEM5 and MEM6 would, respectively, be renamed copies of members 
MEM1 and MEM2 of OLDLF stored unit UNIT3 • Note that /PFILE/, the external 
file name for new unit PU, is specified only once. 

LOAD/OLDLF/ JU/JFILE/*UNIT1 
PU/PFILE/ *UNIT2 

PIMUNIT3 (MEM5=MEM1 , MEM6=MEM2 ) $ 

Restrictions: 

Each specified new run-life data unit (ndu) and resident external file 
name /efn/ must be currently unknown to the run. 

Each specified /efn/ and the external library file (/sefn/) must be 
assigned to the user's job in the external system. Any data currently 
residing on file efn will be destroyed during the creation of run-life 
unit ndu. 

Each specified library file must have been previously created via an 
UNLOAD CS, either in the current or a prior ANOPP run. 
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Each new member must possess a name unique as to the names of all other 
members created on the new unit. 

No member residing on the library file may be the data source for more 
than one new run-life member created by a single LOAD CS. Following 
the specification of JU/JFILE/=UNITl , no subsequent data source speci- 
fied on that LOAD CS , for any new data unit, could be a member of 
OLDLF stored unit UNIT1. 


3.3.2.19 UNLOAD CS 


Purpose ; The UNLOAD control statement establishes a new ANOPP library 
file on a sequential external tape or mass-storaqe file. Copies of current 
run-life data units, optionally consisting of all or some (specified) of 
their resident members, are unloaded onto the library file. Once estab- 
lished, the library file is available as a data source for subsequent 
LOAD CS applications within the current or a future ANOPP run. 

Format ; [label^lUNLQAD/sefn/tdu^ , • ••• «du n l $ 
where each du^ has the format 
du(*n<j , • • . •■n n ) 
label label name 

/sefn/ the name of the sequential external tape or mass-storage file, 
assigned to the user's job in the external system, onto which 
the run-life unit (member) data are to be copied. The sefn 
must not be currently known in the run via a previous 
UNLOAD CS or LOAD CS . 

du the name of a current run-life data unit whose member data are 

to be copied (unloaded) onto the sefn. If no du is specified, 
all run-life data base units (except system units DATA, XSUNIT, 
and XRUNIT) will be copied to the library file. 

wn the name of a specified du resident member that is to be copied 

to the library. If one or more mn's are specified, only those 
named members are copied from that du. If no mn list is 
specified for a du, all of that unit's members are copied to the 
library. 

Examples : 

All data units currently known to the ANOPP run, except for system data 
units XSUNIT, DATA, and XRUNIT, will be unloaded onto the following sequen- 
tial library file TAPE1 : 

LABEL 1 TJNL0AD/TAPE1/ $ 

All run-life data units UNIT1 and UNIT3 will be unloaded as follows; 
UNIT2 will be unloaded but will contain only members MEM3 and MEM5 : 
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UNL0AD/BACKUP/UNIT1 , UNIT2 ( MEM3 , MEM5),UNIT3 $ 

Restrictions: 

No duplication of a combination of data unit and data member is allowed 
on the UNLOAD CS. If a data unit appears more than once on the same 
UNLOAD CS, each occurrence must specify a unique (for that du) member list. 

Once a library file has been established in a run via either a LOAD CS 
or UNLOAD CS, a subsequent UNLOAD CS may not address the same file in the 
same run unless it has been removed from the system by using the DROP CS . 


3.3.2.20 DROP CS 


Purpose : The DROP control statement terminates the ANOPP run assign- 

ment and the job assignment of the external system of a sequential library 
file. The dropped library file will be unaccessible for the rest of the run 
and unaccessible for the rest of the user's job unless its job assignment is 
reestablished via subsequently processed external control cards. 

Format : [label^jDROP /sefn/[ , . . . . ,/sefn/] $ 

label label name 

the external file name of a run— life sequential library file 
whose run and job assignments are to be dropped 

Examples : 

END DROP /TAPE1/, /DISKI/,/ JETS ET/ $ 

DROP /MAS TER F/ $ 

Restrictions : 

When a tape resident library file is dropped, the tape is physically 
unloaded by the external system. 

When a mass-storage resident library file is dropped, that file is no 
longer assigned to the user's job in the external system. 

A new library file (created via an UNLOAD CS) must not be dropped if 
the user intends to reference that file in the external system via subse- 
quently processed external control cards. 

Once a specific library file (sefn) has been dropped in a user's job, 
the same sefn specification may appear on a subsequent UNLOAD CS. However, 
unless the job assignment of the dropped file was reestablished via external 
control cards, the subsequent UNLOAD CS will not address the same physical 
file that was dropped. 
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3.3.2.21 END* Input Terminator 


Purpose: The END* input terminator card indicates the end of a primary 

input stream card-image set required by the previous DATA, UPDATE, or TABLE 
control statement. 

Format : END* $ 

Examples : 

See DATA CS, UPDATE CS, and TABLE CS for specific usage examples. 
Restrictions: 

The END* CS is valid in the primary input stream only. 

A label field is illegal on the END* card. 


3.3.2.22 DATA CS 

Purpose: The DATA control statement creates or recreates a card-image 
(Cl) formatted member on system work unit DATA. The created member may be a 
new version of a member created via a previous DATA CS in the same run. The 
records of the member will be the card images that immediately follow the 
DATA CS in the user's primary input stream. This input card-image set is 
terminated by the first END* card encountered following the DATA CS . 

Format : [label^]DATA^DM=mn $ 

label label name 

DM=mn name of the card-image member to be created on system data unit 
DATA 

Examples: 

LABELA DATA DM=FM1 DATA $ 

12345 .TRUE. 

1.5 2.5 3.4 4.5 5.5 .TRUE. 

END* $ 

DATA DM=PROCMEM $ 

LOAD/ANOPDAT/COANJET, JRS $ 

EXECUTE FMNEWJ UNIT1 =COANJET UNIT2=JRS $ 

DETACH COANJET JRS $ 

END* 5 

Restrictions : 


The DATA CS is legal only in the user's primary input stream. 


The terminating END* card will not be a card image on the created 
member . 
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3.3.2.23 TABLE CS 


Purpose: The TABLE control statement builds a user-specified ANOPP 

data table on a run-life table member. The data table is structured in 
accordance with a set of user-supplied table-description card images. The 
card-image set may reside immediately following the TABLE CS in the user's 
primary input stream or on a user-specified card-image run-life member. 
Description cards required for the definition of ANOPP data table types are 
documented below. 

Format : [label jJ ]TABLE ji du( tm) jJ type ji SOORC^{dun(mn)) $ 

label label name 

du(tn) the data unit name (table member name) on which the data table is 
to reside. The du may be any user-established run-life unit or 
system unit DATA. 

type the integer ANOPP table type of the data table being built. 

Current valid table types are documented below. 

SOURCE- specifies where the table-description card-image set, required 
to define the ANOPP table-type specified, resides. Table- 
description card sets are documented below. 

SOURCE 3 * indicates that the card-image set follows immediately 
behind the TABLE CS in the user's primary input stream, itie set 
must be terminated by an END*- input terminator card. 

SOURCE*dun(mn) indicates run-life data unit name (member name) on 
which the card-image table-description set resides. 

Examples: 

A type-1 data table will be built on unit FMIUNIT resident table member 
FANTAB. The table-description set will be read from card-image member 
FANTDCS residing on system unit DATA as follows: 


LABELA TABLE FMIUNIT( FANTAB ) , 1, SOURCE=DATA ( FANTDCS ) $ 

The same table creation results as for example 1 in section 3.6.1, but 
here the table-description set is read from the user's primary input stream 
and is terminated by an END* card as follows: 


TABLE FMIUNIT (FANTAB) 1 SOURCE** $ 


I NT* 

IND1 = 
DEP* 
END* $ 


table-type-1 description 


card set 


Restriction : A TABLE CS having a specification of SOURCE** is valid 
only in the user's primary input stream; specifications of SOURCE=dun ( mn ) 
are valid in any CS stream. 
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ANOPP data type-1 description cards : The table type-1 description 

cards are of the following format: 


INT* ipc f ipc, ipc 

IND n * ifc, nv, exu,exl, ival^, .... ,ival ny 
DEP* dfCrdval-j ,dval 2 

which are defined as follows: 

INT card contains the integer codes for the interpolation procedure 

that will be permitted on this table 

ipc integer code: 

0 no interpolation 

1 linear interpolation 

2 cubic-spline interpolation 

IND n card contains the description of and the table values for the nth 
independent variable where n < 4 

ifc (format code) the alpha data-type code of the nth 

independent variable 

0 ordered position from 1 to nv; independent 

variable values not entered 

1 integer 

RS real single precision 
RD real double precision 

nv number of values for the nth independent variable 

exu integer code for the extrapolation procedure to be 

used (during interpolation) if a specified value for 
this independent variable falls beyond the last 
table value (ival ny ) for the independent variable 

0 no extrapolation allowed 

1 use the independent-variable table value closest 

to the specified value 

2 extrapolation is linear when using the last two 

table values for the independent variable 

exl integer code for the extrapolation procedure to be 

used (during interpolation) if a specified value for 
this independent variable falls before the first 
table value (ival^) for the independent variable 

0 no extrapolation allowed 

1 use the table value of the independent variable 

closest to the specified value 

2 extrapolation is linear when using the first two 

table values for the independent variable 
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ival 


nv table values for the nth independent variable in 
ascending or descending order. Values are separated 
by blank or comma and may extend over several card 
images. If ifc-O, valuer are not included. 


NOTE: If only a single value is given for the independent variable (nv*l) 

and either exu or exl equals 2, the system will print an informative diag- 
nostic and build the table with the extrapolation pararo (exu or exl) set 
to 1. 

DEP card contains the description and table values for the dependent 

variable and must follow the IND n cards 

(format code) alpha data type of the dependent 
variable 
I integer 

RS real single precision 
RD real double precision 
CS complex single precision 

the table value for the dependent variable, separated 
by commas or blanks, and extending over several card 
images as required. Ttie order of dependent vari- 
ables is such that the first independent variable 
varies first, the second variable varies second, the 
third variable varies third, and the fourth vari- 
able varies last. See table 1 in section 3.1.2 
for numeric- value specification examples. 

END* card required if SOURCE-*. 

Examples of TABLE CS type-1 table descriptions : 

LAB TABLE UNI ( DMS ), 1 , SOURCE-* $ 

INT-0 , 1 

IND2-I, 2,0,1 ,5,10 
IND1 -RS ,3,0,1 ,1 .5, 2.0, 4.5 
DEP-I , 3,5,7,8,9,10 
END* $ 

TABLE UNI (DMT) 1 SOURCE-* $ 

INT-0 1 

IND1-I 2 112 3 
IND2-RS 2 2 2 3.4 7.8 
IND3-RD 222 4D0 3DO 
IND4-RS 2 2 2 3. 2. 

DEP-CS (12. ,12.) (13. ,13.) (13. ,13.) (14. ,14.) (11. ,11.) 

(12. ,12.) (12. ,12.) (13. ,13.) (11. ,11.) (12. ,12.) 

(12. ,12.) (13. ,13.) (10. ,10.) (11. ,11.) (11. ,11.) (12. ,12.) 

END* $ 

NOTE: Currently, the only valid data- table type recognized by ANOPP is 

type 1 . 


dfc 


dval 
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3.3.2.24 The UPDATE CS 
Overview 


The processing of an UPDATE CS in the user's input stream initiates the 
update processing phase. During this phase, the system will generate all 
new members onto a specified run-life data unit. During the update phase, 
and in accordance with a user's set of update directives, the system will 
generate the new unit members by* 

(1) Copying the contents of specified existing run-life members 

( 2) Copying new-member data records directly from the primary input 

stream 

(3) Building new members by combining records copied from an existing 

run-life member and from the user's update directive set 

The UPDATE CS that initiates the update processing phase specifies: 

The new unit to receive the generated members 
The source where the card-image update-directive set resides 
The processing mode (create or revise) for this update phase 
The content of the update processing report 

The new unit to be built during the update phase should have been previously 
established in the run via a CREATE, ATTACH, or LOAD CS. At the start of 
the update phase, any resident members on the user-specified new unit are 
destroyed. The update -directive set is a set of card images that either 
resides on a user-specified run-life member or that immediately follows the 
UPDATE CS in the user's primary input stream (an END* input terminator card 
establishing the end of the directive set). The update directives allow the 
user to define the new members to reside on the unit being built and to 
specify the source of each new member. The update processing mode is deter- 
mined by the user's inclusion or omission of a primary old data unit speci- 
fication on his UPDATE CS. 

The update create mode is in effect if a primary old unit is not speci- 
fied on the user's UPDATE CS. Under this mode, the -ADDR member-level 
directive may be used to generate new members copied from specified run-life 
units or from within the input stream. The -CHANGE member-level directive, 
and its subordinate record-level directives, may be used to mix existing and 
new records onto a new member. In create mode the user must always specify 
on each member-level directive the run-life unit residence of any data- 
source member. Each new member must be generated by a single member- level 
directive application. 

The update revise mode is in effect if the user specifies a primary old 
unit on his UPDATE CS. A specified primary old unit should be the primary 
source of run-life member and record data for the new unit being built. 
Typically, this is an existing unit, the content of which is being revised 
or updated. UPDATE CS applications never result in a change of data occur- 
ring on the old source unit or member. Under the revise mode, the user has 
access to all the directive capabilities available under the create mode, 
including the use of any run- life member as a record source. In addition, 
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he has access to two additional member-level directives, the -COPY and -OMIT 
directives. The -COPY directive allows for copying (unchanged) specified 
members from the primary old data unit. The -OMIT directive allows for 
specific identif ication of primary old data-unit resident members that are 
not to be copied to the new unit. The -COPY and -OMIT directives, used in 
conjunction with the optional UPDATE CS keyword ALL, allow the user to copy 
by default all the primary old unit members not specif ically omitted, 
copied, replaced, or chanqed by a member-level directive. Revise-mode pro- 
cessing also allows the user to default on his data-source unit specifica- 
tion on most update directives, in which case the primary old unit is 
assumed. 

A printed update processing report is produced by the system to 
describe the data unit, member, and record generation that occurred during 
the processing phase just completed. The report will contain as a minimum 
the header section described below. The optional LIST* parameter of the 
UPDATE CS allows the user to select additional sectional content to appear 
in the report. He may specify any combination of the four alpha characters, 
each of which requests a different titled update report section to be 
printed. The report sections, the LIST* value specification that selects 
them, and their information content are given as follows: 

Header section: 

Printed following the completion of each update processing phase 
Contains: 

The update mode (create or revise) in effect during the pro- 
cessing phase 

The name of the new data unit generated 

If revise mode, the name of the primary old unit used 

The source from which the update directive set was read, either 
the user's primary input stream or a run-life data unit name 
(member name) 

The user specified UPDATE CS LIST* selections 

Directive echo section: 

Included in report if LIST* selection contains letter E 
Prints each card image in the user's update directive set 

Summary section: 

Included in report if LIST* selection contains letter S 
Contains: 

The total number of members generated on the new data unit 

For each new member generated: 

The name of the member 

The number of records on the member 

The format specification of the member (records) 

The maximum record length (number of computer storage words) 

The type of the update member-level directive (-COPY, -ADDR, 
or -CHANGE), or the UPDATE CS keyword ALL that controlled 
the generation of the member 
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ADDR member section: 

Included in report if LIST- selection contains letter A 
Contains, for each member generated by a user's -ADDR member-level 
directive: 

The name of the member 

The format specification of the member (records) 

A li3t containing the stored data in each of the member's 
records, presented in either: 

Card-image (10A8) form if member is type Cl (card image) 

Octal code, five internal computer words per line, if member 
is type UNFORMATTED or FORMATTED 

CHANGE member section: 

Included in report if LIST- selection contains letter C 
Contains, for each member generated by a user's -CHANGE member- 
level directive (and its subordinate record— level directives), 
the same information as presented on ADDR member-section reported 
members 

The typical ANOPP user will build data units via the UPDATE CS specify- 
ing either an existing run-life member or a set of input stream records as 
the only source of data for each new member generated. Since the -ADDR 
member-level directive will be their primary tool, these users may wish to 
skip the documentation of the other directives. The large ANOPP application 
user requires the capability to perform record-level member modification and 
generation. He will use the -COPY, -OMIT, and -CHANGE member-level direc- 
tives and the subordinate -INSERT, —DELETE, and —QUIT record— level 
directives. 


The UPDATE control statement initiates the ANOPP update pro- 
cessing phase, during which new resident members are generated onto a user- 
specified run-life data unit. The UPDATE CS requires a set of subordinate 
update directives, read either from within the user's primary input stream 
or from a specified card-image run-life member, lhe update directives allow 
the user to copy specific old members from run— life units onto the new unit; 
to add new members consisting of records read from within the user's update 
directive set; and to build new members by using selective copying, inser- 
tion, and omission of records residing on an old run-life member and/or new 
user input records. At the initiation of the update processing phase, the 
specified run— life unit being built (or rebuilt) is wiped clean. 

Format: 

[laUoel^]UPDATEj|IOLDCNpdu^|]NEMU*ndUjj[ALLj|] SOURCE ^d(mn)^ ^(LIST-x. . .x] $ 
label label name 

OLDO^pdu (optional) keyword specifies the name of a run-life data unit (pdu) 
as the primary source of member and record data for the new mem- 
ber ndu being generated 
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HEHU-ndu 


ALL 


SOURCE- 


LIST-x... 


If specified, the update revise mode will be in effect: the -COPY 

and -OMIT update member-level directives may be used; the UPDATE 
CS keyword parameter ALL may be specified; and record-source 
data unit specifications on certain directives may be defaulted 
to primary unit pdu. 

If omitted, the update create mode will be in effect: the -COPY 

and -OMIT directives may not be used, and the UPDATE CS keyword 
parameter ALL is ignored by the system, 

required keyword parameter specifies the name (ndu) of the run- 
life data unit onto which new members are to be generated. Any 
members resident on the unit will be destroyed at initiation of 
the update processing phase, 

(optional) keyword is meaningful only in update revise mode 
processing. 

If specified under this mode, the final-member generation step 
performed in the processing phase will be a copy to the new 
unit of every member resident on the specified primary old 
data unit (OLDU-pdu), except for: 

A member that was specified as the data-source member via the 
OLDM- keyword parameter on a -ADDR or -CHANGE directive 

A member that was specified on a -COPY or -OMIT directive 

A member whose name matches the name of a new member generated 
on the new unit via a -ADDR or -CHANGE directive 

this keyword specification identifies where the card-imaqe update 
directive set resides 

SOURCE-* is legal only on an UPDATE CS occurring in the user's 
primary input stream. It indicates that the directive-set card 
images follow immediately behind the UPDATE CS, Directive-set 
termination is indicated by the occurrence of an END* input 
terminator card, 

SOURCE-dun(dan) is a legal specification on any UPDATE CS. It 
indicates that the update directive set resides on run-life unit 
dun (card-image member dmn). 

x (optional) value assigned must be a list from one to four 

alpha characters. Each valid character in the specified 
list results in a specific update report section being 
printed. If LIST= is omitted, the update report will 
contain only the header section. The valid list characters 
and the report section they generate are: 

E Directive echo section 
S Summary section 
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C CHANGE member section 
A ADDR member section 


Examples : 

The following run-life unit U1 will contain the new members generated 
in accordance with the update directive set. Since no primary data-source 
unit was specified (OLDU=), only create mode valid directives may be used. 
An update processing report will be printed which contains all sections 
except for the directive echo section. 


Primary input stream 
update directive set 


The following run-life unit NEWFAN will contain the new members gener- 
ated in accordance with the card-image directive set residing on unit 
U7(member MEM9). The update revise mode is in effect with run-life unit 
FANU1 identified as the primary data-source unit; all update directives may 
be used. The ALL keyword specification will result in all unit FANU1 mem- 
bers that were not specified on any member-level directive being copied to 
unit NEWFAN. The omission of the LIST® keyword will result in an update 
report consisting only of the header section. 

UPDATE 0LDU=FANU1 NEWU=NEWFAN ALL S0URCE=U7 ( MEM9 ) $ 


LABI UPDATE NEWU=U1 , SOURCE®*, LIST®SCA $ 

-ADDR \ , , 

-CHANGE ) member-level directives 

-INSERT . • \ 
-DELETE...) record-level directives [ 

-QUIT J J 

END* $ 


The general format of update member-level directives is 

direct! vename, field,. .. .fields $ 

The valid directi venames are as follows: 

-COPY (valid in update revise mode only) 

-OMIT (valid in update revise mode only) 

-ADDR (valid in all update processing modes) 

-CHANGE (valid in all update processing modes) 

The fields are as specified in the following subsection that document 
the individual directives. Labels are illegal on member-level directives. 
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3,3.2.24.1 -COPY Directive 


Purpose : The -COPY update member-level directive will generate one or 

more user-specified new unit members. Each new member is an exact copy of 
the member of the same name residing on the primary old unit (identified by 
the UPDATE CS keyword OLDU=). 

Format : -COPY^mn[ . • • «^nn] $ 

■n the name of the member to be generated on the new unit that will be 

an exact copy of the primary old-unit (OLDU=) resident member of 
the same name 

Examples : 

-COPY LJETO 23 , LJET1 27 , LJET2 1 9 $ 

-COPY LJET0 19 $ 

Restrictions : 


Label fields are not valid on member-level directives. 

The -COPY directive is valid in update revise mode processing only. 

Each specified new member name (mn) must be unique as to all other 
members generated on the new unit via any member-level directive in the same 
update directive set. 


3.3.2.24.2 -OMIT Directive 


Purpose : The -OMIT member-level directive is valid only during update 

revise mode processing initiated by an UPDATE CS on which the keyword "ALL" 
was specified. The -OMIT directive is used to specify the names of one or 
more primary old-unit (UPDATE CS parameter OLDU=) resident members that are 
not to be copied to the new unit during the final revise mode processing 
step. 


Format : -OMITjian^ [ . . . •£ an n l $ 

the name of a member residing on the UPDATE CS specified primary 
old unit (OLDU= ) that is to be omitted from the new unit (NEWU=) 
during update revise mode "ALL" processing 

Examples : 

-OMIT LJETO 24 , LJET1 26 , LJET220 $ 

-OMIT LJETO 20 $ 

Restrictions : 


Label fields are not valid on member-level directives. 
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The -OMIT directive is valid only in a revise mode processing phase 
initiated by an UPDATE CS on which the keyword "ALL" was specified. 

If the same OLDU resident member is specified on both a -COPY directive 
and -OMIT directive in the same set, the specified member will be copied to 
the new unit. 


3.3.2.24.3 -ADDR Directive 


Purpose : The -ADDR update member-level directive allows the user to 

define and generate a member on the new unit being built under any update 
processing mode. The record content of the new member may be copied from 
any specified run-life member (format 1 below) or read from the card images 
that follow the -ADDR in the user's primary input stream (format 2 below). 

When the record data are read from primary input stream card images, 
the user may optionally define the format specification and maximum number 
of records for the new member. 

Format 1 : (valid within a primary or secondary input stream) 

-ADDR ji OLDM=^J| n ^ [ # NEWM=n*n] $ 

OLDH= required keyword specification of the run-life member whose records 
are to be copied to the new unit member being generated. Also, 
the name of the new member if optional keyword NEWM= is omitted 

OLDH=pmn is a valid specification only in update revise mode pro- 
cessing. The specified pmn must be the name of the member resid- 
ing on the primary old unit identified by UPDATE CS keyword 
OLDO . 

OLDH=du(nm) is a specification of the run-life data unit name 
(member name) whose records are to be copied to the new member. 
(This is valid in any update processing mode.) 

NEWM=nmn (optional) specifies the name of the new member nmn being generated 
on the new unit. If omitted, nmn equals the name of the copied 
member, regardless of its unit residence. 

Format 1 examples : 

The following revise mode must be in effect since the run-life resi- 
dence of old member JETMEM1 is assumed to be the primary old unit specified 
by UPDATE CS keyword OLDU= . The new member will be named JET008 and will be 
an exact copy of member JETMEM1 . 

-ADDR 0LDM=JETMEM1 , NEWM=JET008 $ 

The following specification is valid in any update processing mode. 

The record content of member MEM8 , resident on run-life unit UNIT?, will be 


3-43 



copied to the new unit member being generated* The new member will also be 
named MEM8. 

-ADDR 0LDM»UNIT7(MEM8) $ 

Format 1 restrictions : 

The name of the new member, whether specified or assumed, must be 
unique on the new unit. 

Label fields are illegal on member-level directives. 

Format 2: (valid within a user's primary input stream only) 

-ADDR OLDM»*^NEWM=qnn [ ^FORMAT* format] [^MNR*n] $ 

OLDM=* this specification indicates that the record data for new member mn 
is to be read from the card images immediately following the 
-ADDR in the user's update directive set; the record data set is 
terminated by the next member-level directive read or by the END* 
card that terminates the update directive set in the user’s 
primary input stream. The record card-image data must correspond 
to the FORMAT specification supplied or assumed for the new mem- 
ber, as documented below. 

NEWM=an required specification of the name (mn) of the new member being 
generated. The name cannot be a duplicate of the names of the 
other members generated on the new unit. 

FORMAT* (optional) keyword specification of the format type of new mem- 
ber mn. If omitted, F0RMAT=2HCI . 


FORMAT*0 indicates that the records are of undefined format and 
variable length (unformatted). Each data field on the card 

images will be interpreted as an ANOPP data type. The internally 
converted data will be written to the unformatted records. The 
occurrence of a $ on a card image terminates and is not part of 
the data record being built; the data for the next record are 
assumed to begin on the following card image. 


FORMAT*2HCI (default) indicates that a card-image member is to be 
generated. Each image following the -ADDR, up to but not includ- 
ing the next member-level directive or END* card, will be a 
record on the new member. 

FORMATVnflc, , ...,c - $ indicates a fixed or variable length format 

■ n— i 

specification for the new member. The input data card images must 
contain value expressions that correspond in type and sequence 
with the specified format. The occurrence of a $ terminates and 
is not part of the data record being generated. The next input 
record's data are assumed to begin on the next input card image. 
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generated. The next input record* s data are assumed to begin on 
the next input card image. 

HHRa^n (optional) integer specification of the maximum number of records 
that new member mn may contain. If omitted, the system default 
of MNR=1 0000 is used for the new member. 

Format 2 examples ; 

New unit member JETM8 will be generated. Its format will be default- 
type card image (Cl). It will contain three records, each consisting of one 
of the subseguent card images. Member JETM8, which may contain a maximum of 
10 records, is given as follows: 

-ADDR 0LDM=* NEWM=JETM8 MNR=10 $ 

RECORD 1 WILL BE THIS CARD-IMAGE 

RECORD 2 " 

RECORD 3 " 

(Next update member-level directive or the END* input terminator 
card) 

Member M4 is created as a new unit unformatted member containing 
three records and having a default maximum number of record value of 10000. 
The individual records generated will each possess the record length (in 
internal computer storage words) required to store the converted data values 
supplied for it. Those values will be: 

For record 1 - one type RS (real single) value 

For record 2 - two type RD (real double precision) values, one type 
L (logical), one type A3 value (Hollerith string of 
three characters) 

For record 3 - three type I (integer) values 

Member M4 is given as follows: 

-ADDR OLDM=* , NEWM=M4 , FORMA T^O $ 

.693 $ COMMENTS ANYONE? 

.70D+0 1 .898D+20 .TRUE. 3HABC $ 

10 20 30 $ 

(Next member-level directive or the END* input terminator card) 

The following member M5 will be a formatted fixed-length member con- 
taining two records and a value of default of 10000 for a maximum number of 
records: 

-ADDR OLDM=* , NEWM=M5 , FORMAT=1 7HI , 2RS , A9 , RD, CS ,L$ $ 

1 1.5 2E+01 9HJET-STATS 3D-01 (1.5, 2.0) .TRUE. $ 

11 977.8 -.696E-110 9HPROP-STAT 1075.5D+01 ( .696E+29 

.32E+31) .FALSE. $ 

(Next member-level directive or the END* input terminator card) 
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The following member COORD contains the X, Y, Z needed for the geometry 
module: 

-ADDR OLDM=* , NEWM=COORD, FORMAT=4H3RS$ $ 

0. 0. 4. $ 

END* 

Format 2 restrictions : 

The ADDR keyword specification 0LDM=* is valid only within a user's 
primary input stream. 

The name of the new member (NEWM=) must be unique on the new unit beino 
bui It. 


* 
* 
* 


NOTE 


******* 
* 
* 
* 

* 

* 


* The remaining directives in this section are intended for large- * 

* application users who will establish and maintain large data base * 

* applications. * 




3.3.2.24.4 -CHANGE Directive 


Purpose : The —CHANGE update member-level directive allows for the 

generation of a new unit member, whose records will be selectively copied 
from a user-specified old run-life member, with optional insertion of addi- 
tional new records read from within the user's card-image update directive 
set* The sequence and source of new member records to be generated are in 
accordance with a set of card— image record-level directives subordinate to 
the -CHANGE directive. 

The new member will possess the same format as does the specified old 
member; the name and maximum— number-of— records value of the new member may 
optionally be changed from that of the old member. 

A set of record-level directives must immediately follow the -CHANGE 
directive it supports in the update directive set. The occurrence of a 
subsequent member-level directive, or the termination of the user's update 
directive set, ends the -CHANGE subordinate record-level set. 

J^rmat: -CHANGE^LEM- L^n )} [ <J MNR=n] $ 
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OLDH* specifies the run-life member whose resident records will be 

selectively copied onto the new member in accordance with the 
record-level directives set 

OLDM=pnn is valid only in update revise-mode processing* The 
specified old member (pmn) must be resident on the primary old 
unit identified via the UPDATE CS keyword OLDU- specification. 

OLDMsdu(mn) is valid in any update processing mode and specifies 
the run-life data unit name (member name) of the old member. 

NEWM=nmn (optional) specifies the name of the new unit member being 

generated. If omitted, the name of the specified old member 
(OLDM=) will also be assigned to the new member* 

MNR=n (optional) specifies the maximum number of records for integer n 
that the new member may contain. If omitted, the system will 
calculate the new member’s MNR value based on the old member’s 
MNR value and current number of records. 

Examples : 

Since the run-life data unit residence of old member Ml was not speci- 
fied, this must be a revise-mode update, initiated by an UPDATE CS on which 
a primary old unit (OLDU-) was specified. In accordance with the record- 
level directive set, the following new unit member JETM1 will contain 
records selectively read from primary old-unit member Ml and, optionally, 
records read from within the record-level directive set: 

-CHANGE 0LDM=M1 ,NEWM=JETM1 $ 

(Record-level directives) 


(Member-level directive or the end of the user's update directive 
set) 

The following new unit member MEM2 will be created with an assigned 
value of 2000 for maximum number of records. In accordance with the record- 
level directive set, records will be selectively copied to the new member 
from run-life unit FANU member MEM 2. 

-CHANGE 0LDM=FANU( MEM2 ) MNR=2000 $ 

(Record-level directives) 

(Member-level directive) 
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Ttie general format for -CHANGE subordinate record-level directives is 
direct! venane [ ield ...^field] $ 

The valid di recti venames are 
-INSERT -DELETE -QUIT 

The fields are as specified in the following subsections that document 
the individual directives. Labels are illegal on record-level 
directives. The record-level directives are processed under 
control of the preceding -CHANGE member-level directive. The 
-CHANGE directive , documented in the previous section, performs 
the following: 


Identifies the new unit member whose record content will be a changed 
copy of the current content of a run-life old member 

Identifies the old member ( OLDM* ) 

Remains in control until each of its subordinate record-level 
directives have been processed 

Each directive generates the copying of single or groups of records either 
from the old member or from within the directive set. Throughout a record- 
level directive set, the integer operands i and j are used as pointers to 
relative record positions in the old member. Directives within a set must 
be processed (and positioned) sequentially with respect to any i and j oper- 
and specifications they possess. This is necessary because the new member 
is generated in one pass. 

The system monitors an old member reference pointer P throughout the 
generation of a new member via a -CHANGE and its record-level directive 
set. Here, P is initiated at zero. Upon completion of each directives 
processing, P assumes one of the following values: 

(1) The j value (if specified on the directive) 

(2) The i value (if specified, and j value not specified) 

(3) Unchanged (if i value not specified) 

The next record-level directive must have an i value (if present) greater 
then the new value of P. 

The i operand on a directive specifies the relative record position of 
the first record in a sequence of one or more old-member records. Depending 
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on the directive , this single or sequence of old-member records will he 
treated as follows: 

Copied to the new member, optionally to be followed by inserted 
records read from the card images immediately following the directive 
or from elsewhere in the old member 

Omitted from copying to the new member 

The j operand, optionally used on the -DELETE directive, is used to 
specify the last old-member record in a series to be omitted from copying 
to the new member. The i value (if present) on any directive must be 
greater than the i (and j, if present) value specified on a preceding 
directive in the set. For example, a directive referencing old-member 
records 5 through 8 (i through j) must be processed before one referenc- 
ing 9 through 10 through 3 2 ^’ an< * never vice versa. 

The -QUIT directive, if encountered, terminates the new-member genera- 
tion process and the -CHANGE directive's subordinate set. It may specify 
that some, all, or none of the remaining old-member records be copied to the 
new member as a final generation step. If -QUIT is not used, the set termi- 
nates with the occurrence of another update member-level directive or with 
the termination of the update directive set. Deletion (or omission) of old- 
member records from the new-member copy is performed via the -DELETE direc- 
tive. Insertion of new records read from directive set card images is per- 
formed via the -INSERT directive. Reseguencing of old-member records onto 
the new-member records is performed via the -INSERT directive. 


-INSERT Record-Level Directive 

Purpose : The -INSERT record-level directive allows the user to insert 

onto the new member a group of one or more sequentially positioned records, 
either currently residing on the old member or immediately following the 
directive card image in the record-level directive set. 

Optionally, the user may specify that a group of one or more old-member 
records will be copied onto the new member to precede the inserted records. 

Format : -INSBRT^ti^] |fR0II«{6lDm}^|[(.[ ,n] )] $ 

i (optional) the integer relative position of the last old-member 

record to be copied to the new member prior to the specified 
records to be inserted. Integer i must be greater than old- 
member record pointer P. Records P + 1 through and including i 
will be copied to the new member. 

If omitted, P remains unchanged, allowing records to be inserted 
at any position on the new member, including at the beginning 
when P = 0. 
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PROM* 


(optional) specifies the source of the records to be inserted onto 
the new member. If omitted, FROM-* is assumed. 

FROM** (default) indicates that the records to be inserted on the 
new member immediately follow in the directive-set card images. 
The new record card images are terminated by the next record- 
level directive, member-level directive, or termination of the 
directive set. FROM-* is valid in any CS stream, The new record 
data must correspond to the format specification of the -CHANGE 
specified old member. 

If the format of OLDM is unformatted, fixed, or variable, then a $ 
must terminate the data of each input record and the next record 
must begin on a separate card image. Applicable examples are 
presented below and in the following subsections. 

FROM^LDM indicates that the records to be inserted on the new 
member reside on the -CHANGE specified OLDM and are specified 
by the next operand field. 

(m[ ,n] ) (optional) specifies which old-member record (m) or sequence of 
old-member records (m,n) are to be inserted on the new member. 
This field specification has no effect on old-member record 
pointer P. The integer value of m or n may be greater, less 
than, or equal to an i-parameter specification? n, when speci- 
fied, must be greater than m. If FROM-*, this field is ignored. 
If omitted, and FROM-OLDM, all OLDM records will be inserted on 
the new member. 

Examples: 

Example 1 : Assume that N1 is a card-image formatted member on the 

UPDATE CS specified primary old data unit. Assume that the user desires to 
insert two new cards following the sixth card-image record of the old mem- 
ber. The following would copy the first six records onto the new member and 
then insert the two new ones: 

-CHANGE 0LDM-N1 $ 

-INSERT 6 $ 

(Card image) 

(Card image) 

(Next member- level directive) 

Example 2 : The following directive would copy the first six old-member 

records to the new member, to be followed by an insertion of a second copy 
of old-member records 1 through 3. Following this process, P would equal 6. 

-INSERT 6, FROM-OLDM (1,3) $ 

Example 3 : The following is a second example of the -INSERT capability 

to reorganize old-member records onto the new member. The old member con- 
tains 30 records, consisting of 3 functionally related groups of 10 records 
each. Assume that the user wishes to retain all the records but intends to 
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position the second related group (old-member records 11 through 20) at the 
beginning of the new member. The following would perform the desired 
resequencing: 

-INSERT FROM*OLDM (11,20) $ Copy records 11 to 20. 

-INSERT 10 FROM OLDM (21,30) $ Copy records 1 to 1 0 . 

Copy records 21 to 30. 

Example 4: For the following example, assume that the OLDU data unit 

is UNI and the user wishes to create a new unit member based on run-life 
unit UN3 member MEM7 . MEM7 has a fixed-length format specification of 
FORMAT=6H3I, 3L$ • It contains 10 records, all to be retained on the new 
member. The user intends to insert from within his directive set one new 
record behind old-member records 5 and 10. The new member will retain the 
name MEM7 . 

-CHANGE 0LDM*UN3 ( MEM7 ) $ 

-INSERT 5 FROM* * $ 

2765 8329 10754 .TRUE. .TRUE. .FALSE. $ 

-INSERT 10 FROM** $ 

6439 10376 7420 .TRUE. .FALSE. .FALSE. $ 

(Next member-level directive) 

NOTE: Additional -INSERT directive examples are included in the following 

subsections presenting the -DELETE and -OMIT record-level directives. 

Restrictions : 

New data records must correspond to the member format of OLDM. 

A value specification for operand i must be greater than that specified 
for operands i or j on any preceding record— level directive in the set. 


-DELETE Record-Level Directive 

Purpose : The -DELETE member-level directive allows the user to bypass 

old-member records that are not to be copied to the new member being gener- 
ated. Optionally, the user may cause a preceding group of old-member 
records to be copied to the new member. 

Format : -DELETB^il , j ] $ 

i[,j] the integer operands i and j specify a range of old-member 

positioned records that are not to be copied to the new member. 
The i must be greater than the current value of old-member 
pointer P; and j, if specified, must be greater than i. 

If P + 1 is less than i, old-member records P + 1 through 
i - 1 are first copied to the new member. 

Pointer P is set to the value of j, or to the value of i 
if j is not specified. 
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Example: 


Assume that old-member JET1 resides on the primary old data unit and 
contains 20 records. Old-member records 9, 10, 15, 16, and 17 are to be 
deleted. New records are to be inserted following current old-member 
records 5 and 12 on the new member. In addition, current old-member 
records 2 and 3 are to be moved to the end of the records on the new member. 


-CHANGE 0LDM-JET1 $ 


At initiation, old-member record pointer 
is initiated. (P*0) 


-DELETE 2,3 $ 

-INSERT 5 FROM** $ 

(New record N1 card images) 
(New record N2 card images) 


Old-member record 1 is copied. (P=3) 

Old records 4 and 5 are copied. New 
records N1 and N2 are inserted. (P=5) 


-DELETE 9,10 $ 


Old records 6 through 8 are copied. 
(P»10) 


-INSERT 12 FROM** $ 

(New record N3 card images) 

-DELETE 15,17 $ 


Old records 11 and 12 are copied. 
New record N3 is inserted. (P*12) 

Old records 13 and 14 are copied. 

( P* 1 7 ) 


-INSERT 20 FROM=OLDM (2,3) $ 


Old records 18, 19, and 20 are copied. 
Old records 2 and 3 are then copied. 
(P-20) 


(Next member-level directive) 

The new member would now contain: 


OLDM Rec 1 

n "4 

N II J 

New Rec N1 
" " N2 

OLDM Rec 6 

n n y 

n h g 

" * 1 1 

N „ ^ 

New Rec N3 

OLDM Rec 13 
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-QUIT Record-Level Directive 


\ 


y 


Purpose: The -QUIT record-level directive allows the user to terminate 

the generation of the -CHANGE identified new member, optionally specifying 
the final old-member record to be copied to the new member. 

Format : -QUITCH] $ 

i (optional) specifies the integer relative position of the old- 

member record that will be the last record copied to the new 
member. If specified, i must be greater than old-member 
record pointer P. Records P + 1 through and including record 
i will be copied to the new member. If omitted, processing 
of the new-member generation is terminated immediately • 

Examples: 

Assume for both subsequent examples that the old member contains 
20 records and that the preceding record-level directive processed was the 
following: 

-INSERT 15 FROM** $ 

(New record N1 card images) 

Example 1 : The following would result in termination of the -CHANGE- 

initiated new-member generation. The last new-member record will be N1 . 

-QUIT $ 

Example 2 : The following would result in old-member records 16 and 17 

being the last records to be generated on the new member: 

-QUIT 17 $ 

Restrictions : 

The -QUIT directive, if present, must be the last record-level direc- 
tive under the control of the -CHANGE directive. 

A value specification of operand i must be greater than that specified 
for operand i or j on any preceding record— level directive in the set. 


Examples 

The following update processing phase examples incorporate all of the 
member-level and record-level directives. It is assumed that each data 
source unit or new unit identified was established in the run-life data base 
via a preceding CREATE CS, ATTACH CS, or LOAD CS . 

Example 1 : A revised mode update is to be performed by using run-life 

unit OLDJET as the primary old unit. Unit OLDJET contains 20 members named 
MEM1 through MEM20 . 
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Unit NEWJET is the run-life unit to be built (or rebuilt) . NEWJET is 
to receive the following members: 


MEM1 through MEM6 
MEM7 


MEM8 

MEM9 


copied unchanged from unit OLDJET 

rebuilt, using OLDJET Unit MEM7 as its primary 
source member. MEM7 contains eight records; 
records 6 and 7 are to be replaced by user input 
records . 

to be generated by using new input records 

to be a renamed copy of run-life unit UNITFAN 
resident member UFMEM1 


MEM1 0 through MEM1 5 
MEM1 6 


MEM1 7 through MEM20 


copied unchanged from unit OLDJET 

to be a rebuilt version of run-life unit UNITFAN 
resident member UFMEM8. Member UFMEM8 consists of 
10 records; records 4 and 9 are not to be copied 
to new member MEM16. 

copied unchanged from unit OLDJET 


Thus, 


UPDATE 0LDU*0LDJET NEWU*NEWJET SOURCE** LIST*ESCA $ 

-COPY MEM1 , MEM2, MEM 3, MEM4, MEM5, MEM6 $ 

-CHANGE 0LDM=MEM7 $ 

-INSERT 5 FROM** $ 

.TRUE. .TRUE. 17.65D27 7278 (7.53 1E320) $ 

.FALSE. .FALSE. -1D+322 6920 ( 375 .8E-1 2, 270E+1 2) $ 
-DELETE 6,7 $ 

-QUIT 8 $ 

-ADDR OLDM=* NEWM-MEM8 FORMAT* 8H2I , L*RS$ MNR-1 0 $ 

757 9329 .TRUE. 17.97 -3.18E03 $ 

14 723 .TRUE. 1E216 275E+10 18.327 $ 

1278 87 .FALSE. $ 

-ADDR 0LDM*UNITFAN(UFMEM1 ) , NEWM*MEM9 $ 

-COPY MEM10, MEM11, MEM1 2, MEM1 3, MEM1 4, MEM1 5 $ 

-CHANGE OLDM*UNITFAN ( UFMEM8 ) NEWM*MEM1 6 $ 

-DELETE 4 $ 

-DELETE 9 $ 

-QUIT 10 $ 

-COPY MEM17, MEM18, MEM19, MEM20 $ 

END* $ 


Example 2 : A revised mode update is to be performed by using run-life 

unit STAT1 as the primary old unit. STAT1 contains 15 members named MEM1 
through MEM1 5 . 
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Unit NEWSTAT is the run-life unit to be built and is to receive the 
following members: 

MEM1 throuqh MEM4 copied unchanged from unit STAT1 

MEM 5 rebuilt by using system unit DATA member MEMB 

as the primary source member. MEMB is a card- 
image formatted member containing seven cards? 
cards 2 and 7 are to be replaced by user input 
records. 


MEM6 

MEM7 and MEM8 
MEM9 through MEM1 3 


to be generated by using new input records 
renamed copies of unit STAT1 members MEM1 4 and MEM1 5 
copied unchanged from unit STAT1 


Thus, 

UPDATE 0LDU-STAT1 NEWU-N EWSTAT ALL SOURCE-* $ 

-CHANGE OLDM-D ATA (MEMB) NEWM-MEM5 $ 

-INSERT 1 FROM-* $ 

THIS CARD IMAGE WILL BE NEW MEM5 RECORD 2 
-DELETE 2 $ 

-INSERT 6 FROM-* $ 

THIS CARD IMAGE WILL BE NEW MEM5 RECORD 7 
-ADDR OLDM-* NEWM-MEM6 FORMAT-1 6HA7 , L, I ,RS , RD,CS$ $ 

6HHEIGHT .TRUE. 89 + 7.93 17.16D27 (9.75,1E279) $ 

5HSPEED .FALSE. 94757 -1 .33E05 1 .36D-03 (-1 .7E02 0.92) $ 
-OMIT MEM14, MEM1 5 $ 

-ADDR 0LDM-MEM1 4 NEWM-MEM7 $ 

-ADDR OLDM-MEM1 5 NEWM-MEM8 $ 

END* $ 


NOTE: The ALL keyword specification on the UPDATE CS above results in all 

primary old-unit STAT1 members that were not specified on a -OMIT directive, 
and that do not possess a name that is the same as a new unit member gener- 
ated via a -CHANGE or -ADDR directive, being copied unchanged to the new 
unit NEWSTAT during the final update processing phase step. 


3.3.2.25 Conditional Processing CS 
Overview 


The normal processing flow occurring in an ANOPP run is the sequential 
execution of each control statement in the user's input streams. Following 
execution of the last CS in a called secondary stream, the system executes 
the control statement that follows the CALL CS in the calling stream. Exe- 
cution of the ENDCS control statement, marking the end of the user's primary 
input stream, terminates the ANOPP run. 

The user, however, has the capability to deviate from normal sequential 
CS processing through error handling and branch control statements. 
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Controlling subsequent CS processing following the occurrence of a 
system "nonfatal" error *- Prior to execution of each control statement, the 
system sets an internal nonfatal error flag to "off." If during the execu- 
tion of the CS or FM an abnormal but nonfatal condition occurs, the flag is 
set to "on." Documentation of error diagnostics of specific functional module 
and ANOPP system identifies conditions that result in nonfatal errors. 


Following the execution of a functional module or a control statement, 
the system performs this sequence of steps: 

Test the value of the internal nonfatal error flag. 

If "off, w continue processing with next CS in stream. 

If "on" (error occurred), test value of system parameter JCON: 

If JCON* .TRUE, (set by user via SETSYS CS ) , continue process- 
ing with next CS in stream. 

If JCON*. FALSE, (default value), search forward sequentially 
seeking a PROCEED CS: 

If a PROCEED CS is found, continue processing with the execu- 
tion of the CS following it. 

If the ENDCS ending the user's primary input stream is found 
first, terminate the job. 

If, at the time of the error, control was within a secondary input 
stream and JCON= . FALSE. , the search for a PROCEED CS will continue throuqh 
the rest of the secondary stream. The search continues with the remainder 
of the calling stream beginning with the CS following the CALL CS until 
either a PROCEED CS or the run terminating ENDCS is found. 

Determining subsequent CS processing flow based on the current value of 
a user parameter .- The IF control statement allows the user to specify a 
logical condition of several types. The user also specifies a name that 
must be the label field value of another control statement in the same input 
stream. If the specified condition test is .TRUE., processing will continue 
with the execution of the CS having the specified label name? if the condi- 
tion test is .FALSE., processing continues normally with the next sequential 
CS in the stream. 

The GOTO CS performs the single function of transferring processing 
control unconditionally to the control statement having a specific label 
name. The CONTINUE CS is a control statement that may contain a label-name 
field and is used as the object of IF CS or GOTO CS processing, but it 
causes no other action to occur. 


3.3.2.25.1 GOTO CS 

Purpose : The GOTO control statement allows for an unconditional devia- 

tion from the sequential processing within an input stream. Processing will 
continue with the execution of the control statement having the label-field 
value specified. 
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Format : [label^lGOTO^labname $ 

label the optional label name of this control statement 

labnane the required label name of another control statement within 
the same input stream where processing will continue 

Examples: 

ENDST1 GOTO STEP 3 $ 

GOTO STEP 2 $ 

Restriction : Labname must be the label name of a control statement 

within the same input stream as the GOTO CS. 


3.3.2.25.2 IF CS 

Purpose: The IF control statement permxts an alteration in the flow of 

processing if a specified condition exists. The conditional statement is 
specified within parentheses. In the first forra f the value of a user param- 
eter (or parameter array) is logically compared with the value of either 
another user parameter (array) or user-specified constant(s). In the second 
form, the existence or nonexistence of a unit member is determined. If the 
condition within the parentheses is true, then processing continues with the 
control statement having the specified label; otherwise processing continues 
with the next control statement. 


Formats : 


^operator ^ va lue 


label -IF ( paramnaae 1 logical j^para«na«e 2 T\ GOTO- labnaa $ 
* l 1 joperator^ ^ fj * 


label 


label^IF |unit(nea) j GOTO^labna* $ 


label name 


paramname 1 


name of a user parameter whose value(s) is to be com- 
pared with the value(s) following the logical operator 


logical operator a loqical operator used in comparison of the two 

values. Any logical operator is valid for compar- 
ing values which are type integer, real single pre- 
cision, or real double precision. The operators .EQ. 
and .NE. are the only valid operators for logical, 
complex single, and character string data types. 

For the .NE. operator, the results of element comp- 
arisons are combined with an OR . condition . For all 
other operators, the results of element comparisons 
are combined with an AND condition. For the .NE. 
operator, only one element of the first array need 
be unequal to the corresponding element of the 
second array in order for the t f CS to yield a true 
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condition. However, for all other operators, every 
element of the first array compared to correspond- 
ing elements of the second array must yield a true 
condition in order for the IF CS to yield a true 
condition. 


value array of one or more elements of type numerical constant (I, RS, 
RD, CS), logical constant, or string constant. All elements 
must be of the same type. 


paraana*e 2 name of an existing user parameter array to be used in 

comparison 

unit name of data unit on which data member, mem, resides 

■ei name of data member 


AS flag indicating condition is true if unit (mem) exists. If 

unit (mem) exists as a data unit member and flag AS is 
indicated, a true condition results. If unit (mem) does not 
exist and AS is indicated, a false condition results. 

NAS flag indicating condition is true if unit (mem) does not exist. 

If unit (mem) does not exist as a data unit member and flag 
NAS is indicated, a true condition results. If unit (mem) 
exists and NAS is specified, a false condition results. 

labnaa the label of the control statement at which processing should 
continue if the comparison of the two values results in a 
true condition. 


Examples : 

LABEL1 IF (A .GE. B) GOTO LABEL2 $ 

IF (D .EQ. .TRUE.) GOTO LABEL 1 $ 

IF (F .EQ. 6HFVALUE) GOTO LABEL2 $ 

IF (G .GT. 10 20 30) GOTO LABEL 1 $ 

IF (H .EQ. .FALSE. .TRUE.) GOTO LABEL 1 $ 

IF (PROC (SOURCE) AS) GOTO LAB EL 3 $ 

IF (PROC (SOURCE) NAS) GOTO LABEL2 $ 

. 

. 

LABEL2 CONTINUE $ 

# 

LABEL3 CONTINUE $ 


Restrictions; 

Labname must be in the label field of a control statement within the 
same input stream as the IF CS. 

The data type of the second value array must agree with the value type 
of paramname-, . 

When comparing string constants of unequal length, trailing blanks are 
ignored. 
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The number of elements of the second-value array should agree with the 
number of elements of paramname 1 > if not, the condition is assumed false. 


3.3.2.25.3 CONTINUE CS 

Purpose: The CONTINUE control statement provides a no-action step ^ 

within the input stream. It is used mainly with the IF CS and/or GOTO CS to 
allow for an alteration in the flow of control-stream processing. The pro- 
cessing continues with the execution of the CS following the CONTINUE CS. 

Fo rma t : [label^] CONTINUE $ 

label label field 

Example : 

LABEL1 CONTINUE $ 

Restriction: None. 


3.3.2.25.4 PROCEED CS 

Purpose: The PROCEED control statement marks the location within 

the input "stream where ANOPP execution will continue if a nonfatal error 
condition occurs during the processing of a preceding CS or functional 
module and if the current value of system parameter JCON is .FALSE.. The 
PROCEED CS is a no-operation statement when encountered during normal 
sequential CS processing. 

Fo rma t : 

(label^] PROCEED $ 
label label field 

Examples 

ERR0R1 PROCEED $ 

PROCEED $ 

Restrictions : 

During the forward search in the input stream of the system for a 
PROCEED CS , any CALL statements encountered are not processed. (The 
procedure-member resident input stream is not searched or expanded. ) 

If the nonfatal error condition initiating the search for the 
PROCEED CS occurred during processing within a CALL'ed secondary input 
stream, and no PROCEED CS is found to exist in the remainder of that 
stream, the search will continue in the input stream that contained the 
CALL, beginning with the control statement following the CALL CS . 
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If the ENDCS control statement ending the user's primary input stream 
is found before any PROCEED CS, the run will be terminated* 


Examples 

The following examples illustrate conditional processing flow within 
input streams* 

Example 1 : The following input stream illustrates the processing flow 
that will occur if a system nonfatal error occurs during the execution of a 
functional module: 

STARTCS $ 

• 

SETSYS JCON— .TRUE. $ 

EXECUTE FM1 $ 

SETSYS JCON-. FALSE. $ 

EXECUTE FM2 $ 

ATTACH FM3UNIT/EFN3/ $ 

EXECUTE FM3 $ 

DETACH FM3 UNIT $ 

GOTO LASTSTEP $ 

PROCEED $ 

ATTACH FM4UNIT/EFN4/ $ 

EXECUTE FM4 $ 

DETACH FM4UNIT $ 

LASTSTEP EXECUTE FM5 $ 

ENDCS $ 

Since system parameter JCON equals true when functional module FM1 is 
executed, processing will continue with the SETSYS CS that follows it, 
regardless if a nonfatal error occurs during FM1 execution* However, 

JCON*. FALSE, when functional module FM2 is executed. If no nonfatal error 
occurs in FM2 , processing continues with the following ATTACH CS. If a 
nonfatal error does occur in FM2, processing will continue with the 
ATTACH CS following the PROCEED CS. 

Example 2 : The following input stream illustrates conditional pro- 

cessing flow that occurs following the test of a logical condition based on 
the value of a user parameter: 

STARTCS $ 

* 

. 

PARAM EXCOUNT* 0 $ 

REPEAT PARAM COUNT- EXCOUNT + 1 $ 

EXECUTE JET $ 

PARAM EXCOUNT-COUNT $ 

IF (EXCOUNT .NE. 5) GOTO REPEAT $ 

IF ( JETRSLT .E Q. .TRUE.) GOTO JETT $ 

EXECUTE JET9 $ 

GOTO ENDJET $ 

JETT EXECUTE JET7 $ 

ENDJET CONTINUE $ 
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3. 3.2. 26 Checkpoint/Restart CS 


Overview 


The ANOPP system provides the capability to establish checkpoints 
within an input stream(s) of a run and to restart that run in a subsequent 
job without reprocessing the input stream statements that preceded a spe- 
cific checkpoint in the initial run. The intent of checkpoint/restart is to 
save the run environment in the event of either a planned or unplanned 
interruption in an ANOPP execution. This capability may be used to protect 
against system crashes or to halt a run’s execution for examination of 
intermediate data without losing execution time or data base characteris- 
tics. Depending on the results of that examination, the user may specify 
that the operating environment that existed at any specific checkpoint be 
reestablished and execution continued. 

The checkpoint run .- A checkpoint run is any ANOPP run during which a 
CKPNT CS is executed. During the execution of CKPNT CS, the system writes 
to a checkpoint file the necessary internal system and run-life data base 
information required to recreate this run’s current operating environment 
for use in a subsequent restart run. 

The checkpoint/restart file .- During each checkpoint run the user must 
ensure that an external sequential checkpoint file is assigned to the job. 
This checkpoint file must be permanently retained in the external system 
following job termination if it is to be used as the restart file in an 
ANOPP restart run application. The checkpoint/restart file may reside on 
tape or rotating mass storage. 

The checkpoint/restart file structure is divided into primary divisions 
called cycles. Each cycle is referenced by the integer number of its 
sequential position on the file. Cycle 1 would be the first cycle written 
to the file resulting from the first CKPNT CS executed in the checkpoint 
run. Any subsequent CKPNT control statement execution in the run would 
generate another cycle on the checkpoint/restart file. Whenever a 
checkpoint- file cycle is generated during a run, a report is printed identi- 
fying the cycle number, the current run-life data units, and other check- 
point status information that will assist the user in selecting his future 
restart options. In a subsequent restart run the user specifies at what 
position (checkpoint) he wishes to restart his run within the initial pro- 
cessing stream of the checkpoint run. 

Each cycle of the checkpoint file contains the necessary information 
to preserve the current operating environment that existed at the time its 
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generating CKPNT CS was executed. The cycle information contains the 
following: 

All required internal system tables, including those that contain: 

User parameter names and values 

Run-control (initialization and system) parameter values 
Run-life data base directories 

A copy of each nonarchived run-life unit and its members, including 
system unit DATA 

A list of the archived run-life units 

The external name under which the sequential checkpoint file is 
assigned to a user's job must also be established within the run. The user 
may specify the external name of the checkpoint file via the ANOPP CS or 
RSTRT CS specification of initialization parameter CKPNT. If not specified 
in this manner, the system uses the default name of CPFILE. 

The CKPNT CS .- The CKPNT CS is used to establish a checkpoint within 
any input stream in a user's run. The CKPNT CS is not automatically exe- 
cuted when encountered during the processing phases of an ANOPP run. The 
CKPNT CS is treated as inactive (a no-operation CS) if logical system param- 
eter JCKPNT is set to system default value .FALSE* at the time that 
the CKPNT CS is processed. This allows the user to insert CKPNT control 
statements at potential restart locations within the input streams and con- 
trol activation and deactivation via system parameter JCKPNT. A CKPNT CS 
may contain an optional specification of the keyword STOP. If specified on 
an executed CKPNT CS, the ANOPP run will be terminated following generation 
of the checkpoint-file cycle. 

System parameter JCKPNT .- The value of JCKPNT controls all checkpoint 
(CKPNT CS) processing in ANOPP runs. Only when the current value of JCKPNT 
equals .TRUE, is a CKPNT CS executed, resulting in the generation of a new 
checkpoint-file cycle. If the user specifies the name of an external check- 
point file via initialization parameter CKPNT on an ANOPP CS or RSTRT CS, 
the initial value of JCKPNT is set to .TRUE.. The user may also activate 
and deactivate checkpoint processing during his runs via SETSYS CS specifi- 
cations of parameter JCKPNT values. 

The restart run .- Each ANOPP restart run is initiated via the special 
RSTRT control statement. The RSTRT CS must be the first card in the run 
input deck and provides run-initialization capabilities similar to those 
provided by the optional ANOPP CS in nonrestart runs. The RSTRT CS performs 
the following: 

Identifies the run as an ANOPP restart application 

Indicates which previous checkpoint run is to be restarted at what 
checkpoint 

Allows for the change of previous initialization or system parameter 
values 

The optional RSTRT* keyword parameter of the RSTRT control statement is 
used to specify the name under which the user's external restart file is 
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assigned to his job. If omitted, the system assumes that the user's restart 
file has the name RSFILE. 

The RSCYCL» keyword parameter of the RSTRT CS is used to specify the 
integer number of the cycle on the restart file to be used to restart the 
previous checkpoint run. If omitted, the last cycle generated on the file 
will be used. 

Restart-run initialization.- The initialization phase of a restart run 
begins when the RSTRT CS is encountered. Hie RSTRT CS specified restart 
file and cycle are accessed. Hie operating environment preserved by the 
specified cycle is reestablished. Hie initialization steps are as follows: 

(1) System and initialization parameters are assigned their check- 
pointed values or are assigned new values if specified on the RSTRT CS • 

(2) Hie checkpointed run-life data base is reestablished. Each non- 
archived data unit and its members will be copied from the restart file to 
an external file with the same name as the one it resided on at checkpoint 
time. If the user has an external file assigned to the restart job that 
matches a file name of a checkpointed unit stored on the restart file, that 
external file will receive the copy; otherwise, the system will use a 
scratch (temporary) file of the same name. Hie system unit DATA is regener- 
ated by using checkpoint cycle copies. No archived data unit file that 
existed in the checkpointed run-life data base will be regenerated. Hie 
user has the responsibility of ensuring that the external files on which 
archived units reside are assigned to his restart job. Hie user must ensure 
that any library files reguired by subseguent restart-run processing are 
externally assigned to his job. 

(3) Hie user parameter tables and data unit directory are reestablished 
with checkpointed values. 

(4) System parameter JRSTRT is set to .TRUE., indicating that ANOPP 
restart run processing is to occur. 

Following initialization, the next processing step depends on whether 
the user has supplied a new primary input stream in his run input deck. If 
the RSTRT CS was the only card image in the input deck, run processing 
resumes with the execution of the control statement within the initial— run 
input stream which followed the CKPNT CS that generated the applicable 
checkpoint (restart) cycle. 

An inserted primary input stream can be processed either prior to or 
instead of the resumption of checkpointed input stream processing as 
described above. An inserted primary input stream may not contain a CKPNT 
control statement. 

The value of logical system parameter JRSTRT upon completion of the 
inserted input stream (ENDCS) processing determines whether the run will 
terminate or resume processing the checkpointed input stream. Hie JRSTRT is 
set to .TRUE, during restart-run initialization. If the user has changed 
its value to .FALSE., and the ENDCS is processed, the run will be terminated 
at that point. If JRSTRT is equal to .TRUE, at ENDCS process time, run 
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processing will continue with the execution of the control statement that 
follows the applicable CKPNT CS within the checkpointed input streams. 


3.3.2.26.1 CKPNT CS 

Purpose : The CKPNT control statement establishes a potential check- 

point within a user's run. A CKPNT CS is executed only when system param- 
eter JCKPNT».TRUE.; each execution generates a new cycle on a predesignated 
checkpoint file. The checkpoint cycle contains the internal system and run- 
life data base information required to preserve the current operating envi- 
ronment for use in subsequent restart runs. 

Format : [label^lCKPNTljiSTOPl $ 

label label name 

STOP optional keyword. If specified on an executed CKPNT CS, 
the run will terminate following the generation of the 
checkpoint file cycle preserving the current-run operat- 
ing environment. 

Examples : 

LABEL1 CKPNT S 
CKPNT STOP $ 

Res triction : The CKPNT CS is valid within any input stream except for 
a primary input stream inserted in an ANOPP restart run. 


3.3.2.26.2 RSTRT CS 


Purpose : The RSTRT control statement identifies a restart run and 

reestablishes a checkpointed operating environment. It identifies, through 
the specification or omission of keyword parameters, the name of the exter- 
nal restart file and the checkpoint cycle on the file where the operating 
environment to be reestablished is preserved. 

The RSTRT CS also allows the user to specify new values for initializa- 
tion and system parameters. Table 3.3-3 in this section presents those 
parameters subject to RSTRT CS specification. 

Format : 

RSTRT ( ^RSTRT=sefn] [ ^RSCTCL-cn] [ (J para*na»e 1 =value 1 ... . ) |paraanaBe n «value Q ] $ 

RSTRT=*sefn optional keyword specification of the external file name 

(sefn) by which the restart file must he currently assigned 
to the user's job. If omitted, RSTRT=RSFILE is assumed. 
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RSCYCL-cn 


paxauname 


value 


optional keyword specification of the integer checkpoint 
cycle number on the restart file from which the operating 
environment is to be reestablished at the initiation of 
this run. If omitted, the last cycle on the restart file 
is used. 

optional specification of the name of a run-control initial- 
ization or system parameter whose checkpointed value is to 
be changed. (See Table 3.3-3.) 

the new value to be assigned the specified paramname at 
initialization of the restart run 


Examples: 

RSTRT $ 

RSTRT RSTRT^RFILEIN L ENGL* 30000 CKPNT-NEWRFLE $ 

RSTRT RS CYCLE* 3, JECHO.TRUE. $ 

Restrictions : 

RSTRT CS is valid only as the first CS and, optionally, the only CS in 
a restart run input deck. 

The specified or assumed external file name (sefn) of the restart file 
may not be the same as the external file name of any sequential library file 
or run-life data-unit file used within the run. 


Examples 

Checkpoint run example 1: For the following example, the run is ini- 

tialized with checkpoint processing active via the initialization parameter 
CKPNT specification on the ANOPP CS; system parameter JCKPNT is automati- 
cally initialized as .TRUE.; and external sequential file JETFILE is identi 
fied as the checkpoint file: 

ANOPP CKPNT* JETFILE $ 

STARTCS $ 

CPI CKPNT $ 

e 

* 

IF (KEY ITEM .EQ. .TRUE.) GOTO CP 2 $ 

SETSYS JCKPNT* . FALSE . $ 

CP 2 CKPTN STOP $ 

SETSYS JCKPNT*. TRUE. $ 

CP 3 CKPNT STOP $ 

. 

ENDCS $ 
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Table 3.3-3. RSTRT CS Initialization and System Parameters 


Parameter 

Parameter 


Value 


Default 

name 

type 

ucscr lp^ion 

Type 

Range 

value 

ACCOUNT 

Sys tem 4 

Controls accumulation of cost-accounting 
data associated with each functional 
module or executive processor 

ACCOUNT-. TRUE. - accumulate accounting data 
ACCOUNT-, FALSE. - do not accumulate 
accounting data 

Logical 

.TRUE. 

.FALSE. 

.FALSE. 

CKPNT 

1 

1 

Initiali- 

zation 

Identifies name of external checkpoint file 
to be generated during run. Its speci- 
fication also results in system parameter 
JCKPNT being initialized as .TRUE., auto- 
matically activating checkpoint process- 
ing in the run 

Alphanumeric 
name of 
seven 

characters 
or less 


CPFILE 

JECHO 

System 4 

Controls printing of CS card image upon 
validation in primary edit phase (primary 
input stream editing) and secondary edit 
phases (procedure member-editing) 

JECHO* .TRUE* - print CS card images 
JECHO-. FALSE. - do not print CS card 
images 

Logical 

.TRUE. 

.FALSE. 

.FALSE. 

JLOG 

System 4 

Control printing of CS card images upon 
execution in executive processing 
phases 

JLOG— .TRUE. - print CS card images 
JLOG-. FALSE. - do not print CS card 

images 

Logical 

t 

.TRUE. 

.FALSE. 

.TRUE. 

LENGL 

Initiali- 

zation 

Controls size (number of computer words 
within user's job field length) assigned 
to global dynamic stores (GDS) for this 
ANOPP run 

Integer 

^3000 

12000 

NAETD 

Initiali- 

zation 

Controls number of table-directory entries 
initially allocated for this ANOPP run 

Integer 


10 

NAEUD 

Initiali- 

zation 

Controls number of data unit directory 
entries initially allocated for this 
ANOPP run 

Integer 

£5 

25 

NLPPM 

Initiali- 

zation 

Controls number of lines per page to be 
used for ANOPP printed output during 
this run 

Integer 

>15 

48 

NOGO 

.■ 1 

Initiali- 

zation 

Determine if ANOPP run is to be limited 
to primary-edit-phase execution only 

NOGO-.TRUEe - primary -edit-phase-only 
run 

NOGO-. FALSE. - normal ANOPP run 

Logical 

.TRUE. 

.FALSE. 

.FALSE. 


Usage discussions for each of the initialization para«eters are presented in Table 3.3—1. 


3-66 


ORIGINAL PAGE IS 
OF POOR QUALITY 




Checkpoint CPI will be executed. However, the next checkpoint to be 
executed depends on the result of the IF CS test. Checkpoint CP2 will be 
executed if logical user param KEY ITEM*. TRUE, followed by run termination 
via the STOP keyword specification on the CKPNT CS. Otherwise, the SETSYS 
CS preceding checkpoint CP2 will deactivate checkpoint processing and CP2 
CKPNT will be ignored. In this case, checkpoint CP3 would subsequently be 
executed and terminate the run. 

Chec kpoint run example 2 : For the following example, the run would be 

initialized with checkpoint processing inactive (system param JCKPNT set to 
default value .FALSE.). Checkpoint CKP1 would not be executed. 

STARTCS $ 

CKP1 CKPNT $ 


SETSYS JCKPNT*. TRUE. $ 

CKP2 CKPNT $ 

ENDCS $ 

The SETSYS CS specification of JCKPNT* .TRUE, would initialize check- 
point processing in the run. The checkpoint file used will have the default 
external name of CPFILE. Checkpoint CKP2 will be executed, followed by 
continued run processing since the CKPNT CS keyword STOP was not specified. 

Restart run example 1 : Assume that the following CS is the only card 

image in the user's input stream, that this is a restart of the run shown in 
checkpoint run example 1 above, and that the CKPNT CS labeled CP2 was the 
last checkpoint executed in that run: 

RSTRT RSTRT*JETFILE CKPNT-NEWCPF $ 

The operating environment preserved by CKPNT CP2 will be reestablished 
since RSTRT CS keyword RSCYCL was not specified and the last cycle found on 
the restart file is used by default. Since the RSTRT CS also specifies 
initialization parameter CKPNT, checkpoint processing will also be initially 
active during this restart run. Processing will resume with the execution 
of the control statement in the input stream of the checkpointed run that 
follows the CKPNT CS labeled CP2 . Subsequent execution of CKPNT control 
statements will result in new checkpoint cycles being generated on checx- 
point file NEWCPF • 

Restart run example 2 : Again, assume that the following is a restart 

of the run shown in checkpoint run example 1 above. Since the RSTRT Ca 
keyword RSTRT* is not specified, the system assumes that the user s res r 
file is assigned to this job by the default external file name RSFILE. 
Keyword RSCYCL specified that cycle 1 on the file, generated by the CKPNT cb 
labeled CPI in the checkpointed run, will be used to reestablish the operat 
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ing environment. The user has also chosen to reset the checkpointed value 
of system parameter JECHO to .FALSE.. 

RSTRT RSCYCL-1 JECHO. FALSE. $ 

STARTCS $ 

• 

EXECUTE FHJET $ 

IF ( FMRESULT .EQ. .TRUE.) GOTO ENDIT $ 

SETSYS JRSTRT*. FALSE. $ 

ENDIT ENDCS $ 

Following initialization, processing will resume with the execution of 
the inserted primary input stream above. Following the execution of the 
ENDCS ending the inserted stream, the system will check the current value of 
system parameter JRSTRT : 

If JRSTRO .FALSE. , restart run processing terminates. 

If JRSTRT is still set at restart-run initial value .TRUE., 
processing will continue with the execution of the control statement 
following the CKPNT CS labeled CPI in the input stream of the check- 
pointed run. 
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3.4 INPUT/OUTPUT REQUIREMENT FOR FUNCTIONAL MODULES 

This section describes the Input/output requirements for each 
functional module In GAPAS. The required I/O Is either In the form of user 
parameters or data units. Data units required by users are described in 
detail, Including record formats. Data units created Internally within 
functional modules are described briefly. Functional modules are 
implemented by using the EXECUTE control statement. 


01-168-86 
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ATMOSPHERIC PROPERTIES MODULE (ATM) 

PURPOSE: TO CALCULATE THE ATMOSPHERIC PROPERTIES AT A SPECIFIED 

ALTITUDE 

INPUT: 

USER PARAMETER 

ALTUDE Altitude of aircraft in feet. 

OUTPUT: 

USER PARAMETERS 

VISC Viscosity in slug/sec-ft 

PRESS Ambient pressure in lbf/ft**2 

TEMP Ambient temperature in degree F 

RHOA Ambient density in slug/ft**3 

CO Speed of sound in ft/sec 


01-168-86 
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GEOMETRY GENERATOR MODULE (GEOGEN) 

PURPOSE: TO CALCULATE PROPELLER GEOMETRY DATA FOR THE 

AERODYNAMIC STRUCTURAL AND ACOUSTIC MODULES 


INPUT 


USER PARAMETERS: 


IGLOBE 

ISPACE 
I START 
IOPT 


NIN 

BETA3Q 

IROT 


INPRNT 

MAXIT 

EPSSHR 

EMOD 

POISS 

DENS 


Control flag, =1 for input sections given on global 
spaced coordinates. = 0 for sections given 
in local coordinates. (default * 0) . „ 

Control flag, =0 for section coordinate with nice 
spacing; =1 with arbitrary spacing (DEF * 1) 

Control flag, =0 when GAPAS is being executed the 
first time through (DEF =0) 

Options for geometry output, -10 output for sections 
normal to PCA, 1/4 -chord line and elastic axis 
is required. (DEF =10) 

Number of input sections 

Delta blade angle at 3/4 radius of propeller m 

DEG. (DEF =0.0) . 

Index indicating rotational direction. -0 tor 
clockwise rotation (i.e., SR5) =1 for counter 
clockwise rotation (i.e., H101/16) (DEF = 0) 
Control flag for debug print.' =0 no debug print. 

(DEF =0) , ! 

Maximum number of iterations for shear center cal- 
culation. (DEF = 10) . 

Convergence criterion for shear center iterations 

Young's modulus for propeller material. PSI/IN 
(DEF = 1.5E+7) 

Poisson ratio (DEF - 0.3) 

Density of propeller material in LBM/ (CUB. FT) 

(DEF = .17) 


DATA UNITS (MEMBER) : 

GEOM (RSLICE) - Input member containing locations along PCA 
where calculations . are to be performed and output for a ®*°” 
dynamic, structural and acoustic modules. This member contains 
2 records . The first record is the number of slices and the 
second record is an array of output locations. (m inch) 

GEOM (XCOOR) - Incut member containing chordwise locations 
where calculations are to be performed and is 

a 2-record member; the first is the number of output station 
and second record is an array of output stations. (dimen- 
sionless) 
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GEOM (MSLICE) - Input member containing coordinates of span- 
wise sections. The format of this member is as follows: 

RECORD DESCRIPTION 

1 Number of chordwise station for 1st section. 

2 (x,y,z) coordinate 


• (x,y,z) and ply angle of last chordwise station 

NSLICE+2 Leading edge alignment, horizontal ref. length, 

chord length, blade angle (DEG.) spanwise location 
(in inch) number of chordwise stations for 2nd 
section. 

(x,y,z) coordinate 


(The total number of sections depends on user parameter NIN.) 


GEOM(ARBLINE) - This is a multi -record member containing the 
global coordinates of an arbitrary line upon which input sections 
are based. 

RESTART(XYZPLY) - This is a multi -record member created by 
the BEAM module for the operation of GAPAS multiple-pass mode. This 
member contains information of a deflected elastic axis. Specific- 
ally, it contains the three coordinates and the ply angle of each 
peripheral point of a section normal to the elastic axis. It also 
contains the leading edge alignment, horizontal length, chord length 
and twist angle for each section. 

RESTART (DELXYZ) - This is a multi -record member created by 
the BEAM module for the multiple-pass mode operation. It contains 
the deflection (in three directions) and the twisting of the elastic 
axis for each spanwise station. 

OUTPUT 

DATA UNITS: 

STRUC(BPROP) - This is a multi -record member created for the 
use of the BEAM module. It contains structual properties for each 
section normal to elastic axis. 

STRUC(SHRCNTR) - This is a multi -record member created by the 
shear center routines embedded in GEOGEN module. It contains the 
three coordinates of the calculated shear center for each spanwise 
station. 


01-168-86 
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GEOH(BEAMXLE) - This is a mul ti -record member created for the 
use of PROPCHG module. It is used for the determination of surface 
loading to be input in the structure BEAM module. It contains the 
leading edge coordinates of sections normal to the elastic axis. 

GEOM(BMATRIX) - This is a multi -record member to be used by 
the performance module (PROPCHG). It is used for the determination 
of surface loading to be input in the BEAM module. It contains the 
coordinate transformation matrix of sections normal to the elastic 
axis. 


GEOM(BLADE) - This is a multi -record member created for the 
use of acoustic modules. It contains the local coordinates, blade 
angle and nose radius of each output section normal to the pitch 
change axis. 

GEOM(BLADEG) - This is a transient multi-record member 
created for the internal use of GEOGEN module. It contains the 
global coordinates of each peripheral points of sections normal to 
the pitch change axis. 

GEOM(BLADEL) - this is a multi -record member created for the 
internal use of a pressure loading module (PLD). It contains the 
local coordinates of each perpheral point of sections normal to the 
pitch change axis. 

GEOM(DERIV) - This is a multi-record member which contains 
the first derivative of airfoil sections at various peripheral 
points. This member is created for the use of TRANSEP module. 

GEOM(SCRATCH) - This is a multi -record member generated in 
GEOGEN module. It contains the spline fit coefficients for internal 
use within the GEOGEN module. This is a transient data member and 
therefore not used in any other part of GAPAS. 

GE0M(X14CHD) - This is a multi -record member created by 
GEOGEN module and used in PROPCHG module. It contains the 
coordinates of mid-points between vortices along the 1/4-chord line. 

GE0M(X34CHD) - This is a multi -record member for the use of 
PROPCHG module. It contains the coordinates and the normal vectors 
of control points along the 3/4-chord line. 

GEOM(RNOSE) - This is a multi -record member created for the 
use of PROPCHG module. It contains the nose radius, thickness/chord 
ratio, chord length, blade angle, area of airfoil and camber, for 
sections normal to the pitch change axis. 

GEOM(MATRIX) - This is multi-record member created for the 
use of JUMPER. It contains the coordinate transformation matrix for 
points in the propeller plane. 
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GEOM(VCHORD) - This is a multi-record created for the 
PROPCHG module. It contains the vector components of the chord of 
each section. 

GEOM(AIRFOIL) - This is a multi -record member created for 
the use of TRANSEP MODULE. It contains the coordinates of each 
perpheral points for sections normal to the 1/4-chord line. 

GEOM(XVORTX) - This is a multi -record member created by the 
GEOGEN module and used in the PROPCHG module. It contains the 
coordinates of the 1/4-chord line for each spanwise station. 


JUMPER PROPELLER FLOWFIELD MODULE (JUMPER) 

PURPOSE: TO CALCULATE FLOWFIELD OF AIRCRAFT AND PROPELLER PLANE 

INPUT 

USER PARAMETERS: 

VCOM Free stream velocity (IN FT/SEC) 

ALPHA Aircraft angle of attack (IN DEG.) 

YAW Aircraft angle of YAW (IN DEG.) 

XREF Reference length for output purpose (INCH) 

R Propeller blade radius (INCH) 

ERR Exponent for the value of largest relative error 

between solution iteration (DEF = -4.0) 

RPM Rotational speed (REV /MIN) 

NSYMET Control flag for symmetry. =0 body and wing are 
symmetric about X-Z plane. =1 not symmetric. 

(DEF = 0) 

NLIST Output flag. =0, print out body panel. (DEF = 1) 

NCALC Flow solution flag. =0, perform flow solution; 

=1, no solution (this is for test run) (DEF = 0) 
NWING Control flag. =0, wing is not modeled. =1, wing is 
modeled. (DEF =0) 

ITMAX Maximum number of iterations (DEF = 25) 

NAZIMU Number of azimuthal stations. (DEF = 1) 

NSLICE Number of spanwise stations where velocity on 

propeller plane is to be determined. (DEF = 11) 
NINFLO Number of inlet or outlet panels on aircraft body . 
(DEF * 0) 

NPOINT Control flag. =0, velocity on propeller plane 
not to be determined. =1, flowfield required. 

(DEF = 1) 


01-168-86 
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DATA UNITS (MEMBER) : 

AIRCRAFT (BODY) - INPUT MULTI-RECORD MEMBER CONTAINING AIRCRAFT 
BODY PANELING DATA. 

RECORD DESCRIPTION 

1 Total number of body cross sections (NSECTO) _ 

2 Cross section sequence number, number of penp ery 
points on the 1st section (NIP), control flag 
indicating the section is to be repeated (=0), 

or not to be repeated (-1). 

3 ( X ,y, z ) coordinates of the 1st periphery point on 

4 <x!y!Jf coordinates of the 2nd periphery point on 
1st section. 

5 

6 

NIP+2 (i'.y'.i) coordinates of the NIP-TH periphery point 
on 1st section. 

(x,y,z) coordinates of the 1st periphery point on 
2nd section. 

fRFrnRD 2 3 ..NIP+ repeat for each section, up to NSECTO) 
’aircraft (WING) -data member containing information 
related to the wing. This member is required only 
if NWING = 1. 

RECORD DESCRIPTION 

1 (x.y.z) coordinate of wing root quarter chord 

2 Wingspan, wing root chord length, wing dihedral 
angle, (DEG.) sweep angle (DEG.), wing lift 
coeffieient. 

AIRCRAFT (PROP) - DATA MEMBER CONTAINING IINFORMATION RELATED 

TO Speller PLANE location and orientation, this member is 

REQUIRED ONLY IF NPOINT - 1. 

record description 

1 (X,y,z) coordinate of hub of center point of pro- 
peller plane in reference aircraft coordinate 

2 Built-in vertical tilt angle of propeller plane 
(DEG) , built-in sidway tilt angle of propelle 
plane . 
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DATA UNITS: 


AIRCRFT(INLET) - This is a one or multi- record member 
containing flow rates for the inlets of an aircraft. This data 
member is not required for input if user parameter NINFLO = 0. 

AIRCRFT(WING) - This is a multi-record member containing the 
coordinates of the 1/4-chord point of the root section of wing, and 
the span, chord length, dihedral angle and sweep angle of wing. 

This data member is not required for input if user parameter NWING=0 

GEOM(MATRIX) - This member is created by GEOGEN module. Refer 
to GEOGEN input/output for description. 

GEOM(X14CHO) - This member is created by GEOGEN module. Refer 
to GEOGEN input/output for description. 

OUTPUT 

AIRCRFT(SCRATCH) - This is a transient multi-record member for 
the internal use of JUMPER module. It contains coordinate trans- 
formation matrices for points on the propeller plane. 

AIRCRFT (COEFF) - This is a transient multi-record member 
containing elements of a matrix related to each panel. 

AIRCRFT(ATTACK) - This is a multi- record member containing 
the angle of attack of airfoil at each spanwise station. This is 
used in PROPCHG module. 

AIRCRFT(VHN) - This is a multi-record member containg the 
three vector components of inflow. It is used in TRANSEP and 
PROPCHG modules. 

AIRCRFT(FLOWQRT) - This is a multi-record member containing 
the three velocity components of inflow normal to airfoil sections 
of each spanwise station. 
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TRANSEP AIRFOIL LOADING MODULE 


INPUT 


USER PARAMETER: 

XIBDLY - the x- location (x/c) at which transition is assumed 
to occur on upper surface. The relationship to percent 
chord is: XIBDLY=(%chord-50 . ) /100 . 

XLBDLY - the x-location at which transition is assumed to 
occur on lower surface. 

XSEP - x-location after which the Nash-Macdonald separation 
parameter can assume its calculated value. Used only in 
the viscous interaction case. 


XLSEP - location at which the trailing edge correction pro- 
cedure begins . Use only if ITEUPC and/or ITELWC — 1 . 
Default 0.5. 


XPC - location after which the lower surface displacement 
thickness is required to continue decreasing once it has 
started to decrease. Upstream of XPC, the displacement 
thickness is to be monotonically increasing. Default <J.i. 

ITACT - viscous interaction control parameter. It should^be 
set to 0 for analysis mode without interaction. Default 

ISKP2 - airfoil update control parameter. It is 0 if on 
grid 2 an update is desired every 10 iterations. Default 

= 0 . 


ISKP3 - same as ISKP2 but for grid 3 (medium grid) 


ISKP4 - same as ISKP2 but for grid 4 (fine grid) 


IREAD - starting solution parameter. If I READ— 0 the mi 
perturbation solution is assumed to be everywhere zero. It 
IREAD=1 an initial solution is input. Default - 0. 


ITEUPC - upper surface trailing edge correction control 
parameter. If ITEUPC=0 correction is not desired. 

Default = 0. 

ITELWC - same as ITEUPC but for lower surface. Default = 0 


W - relaxation factor for subsonic points. Default 1.7. 


EPS - subsonic damping factor to match difference equations 
at sonic line if needed. Default - 0.0. 

EPSS - supersonic damping factor for iterative stability. 
Default =0.4. 
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CONV - convergence criteria control value. Default = 
l.E-05 


A1 - stretching constant for the Y direction. Default = 
.246 

A2 - first stretching constant for the X direction. 
Default = . 15 


A3 - second stretching constant for X direction. 

Default =3.87 

X4 - the positive X location where coordinate stretching 
changes. Default. 0.49 

S4 - the positive value in computational plane where 
stretching changes. Default =2.0 

IMAX - number of vertical grid lines in horizonital di- 
rection. Default =13 

JMAX - number of horizontal grid lines in vertical direc- 
tion. Default = 7 

MITER - Maximum number of iterations allowed on first 
grid. Default = 800 

NHALF - number of grid refinements to be done. Default = 2 

LP - relaxation cycle interval at which boundary layer, 
coordinates are printed. Default = 1000 (no printout) 

RN - Reynold's number based on chord length 

ALP - angle of attack (DEG. ) 
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DATA UNITS: 


AIRCRFT (VHN) - member containing the inflow velocity 
components. It is created by the JUMPER module. Refer to JUMPER 
for detailed description. 

PROP(CLZM) - member containing the free stream Mach number 
for all mid sections between two adjacent airfoil sections normal to 
the 1/4-chord line. 

GEOM(DERIV) , GEOM(AIRFOIL) , GEOM(RNOSE) - These are member 
created by the geometry generator, GEOGEN. Refer to GEOGEN for 
detailed description. 

I N IT (SOLTION) - a multi -record member containing an initial 
guess of the flowfield around an airfoil. This is not a required 
input if user parameter IREAD=0. 

OUTPUT 

COEFF(CDRl) , C0EFF(CDR2) members containing lift, drag 

and moment coefficients for each section. They are created for 
performance calculations in PROPCHG module. The structure of the 
member is the same as that described in NACA16 module. 

COEFF(CP) - multi-record member containing the pressure 
coefficient on upper and lower surface of an airfoil. It includes 
all sections at specified spanwise stations. 
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AIRFOIL DATABANK (NACA16) 


PURPOSE: TO CALCULATE LIFT AND DRAG AT SPECIFIED ANGLE OF 

ATTACK 

USER PARAMETERS: 

ALP Angle of attack (DEG.) 

RN Reynold's number based on chord length 

MACH Free stream MACH number. Default = 0.5 

ALPHAO Angle of zero lift (DEG.) Default = -3.5 

CLD Design lift coefficient 

VISC Viscosity of ambient air. (FT**2/SEC). 

Default = 1.59E-04 

VCOM Free stream velocity (FT/SEC). Default - 880 
ICL Lift coefficient compressibility check factor. 

ICL=0, gives incompressible lift coeff. ICL=1 , 
gives compressible lift coeff. Default = 1. 

ICD Same as ICL, but for DRAG coefficient. Default = 1 

MP Moment coefficient parameter. MP=0 , moment coeff 

not desired. MP=1 , moment coeff. About the leading 
edge, MP=2 , moment coeff. about the 1/4 -chord. 
Default = 2 

IFORM Output control flag. Default = 1. 

TC Thickness to chord ratio 
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GEOM(RNOSE) - multi-record member containing section 
properties. Refer to GEOGEN for detailed description. 

AIRCRFT (ATTACK) - multi-record member containing angle ot 
attack for airfoil sections at each spanwise station. Refer to 
JUMPER module for detailed description. 

PROP(CLD) - multi-record member containing the design lift 
coefficients for airfoil sections at each specified spanwise 
station. 


OUTPUT 

COEFF(CDRl) , COEFF (CDR2) , . . . . - multi -record member 
containing angle of attack, Reynold's number, free stream Mach 
number, and lift and drag coefficients, and moment coefficients 
about 1/4-chordpoi nt and leading edge. CDR1, CDR2, ... are members 
for each spanwise station. 


3-81 



CLARK- Y DATABANK (CLARKY) 

PURPOSE: TO CALCULATE LIFT, DRAG AND MOMENT COEFFICIENTS AT 

SPECIFIED ANGLE OF ATTACK AND SECTION PROPERTIES. 

INPUT 

USER PARAMETERS: 

ALP - Angle of attack in degree. 

RN - Reynold's number. 

MACH - Free stream Mach number. 

TC - Thickness/chord ratio. 

CHORD - Chord length in feet. 

ALTUDE - Altitude of aircraft in feet. 

OUTPUT 
DATA UNIT: 

COEFF(CDRl), C0EFF(CDR2) , . . . multi -record member containing 
the lift, drag and moment coefficients. The structure of this 
member is same as that of NACA16. Refer to NACA16 for detailed 
discussion. 
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PROPELLER PERFORMANCE MODULE (PROPCHG) 

PURPOSE- TO CALCULATE PROPELLER PERFORMANCE AND AERODYNAMIC 
PURPOSE. ^^ U FQR STRU ctURE AND ACOUSTICS MODULE 


INPUT 

USER PARAMETERS: 


NB 

NSLICE 

MPROP 

INDUC 


LWRITE 

BETAW 

MACH 

AJ 

R 

RHOA 

VCOM 


Number of vortex elements used for calculations 
The index number of vortex element where proplet 

Control 1 * flag to output induced velocity at desig- 
ned locations. IHDUC-1. output is desired. 

ID2-0^ C inflow velocity calculated in Jumper module 
used ID2=1, uniform inflow. Default 0 
ID-ot normal vector of 3/4 chord line calculated 
internally is used. ID-1, use normal vector 
calculated in GEOGEN module. ? ef * ult n , 0 

If LWRITE=1 DEBUG print is desired. Default 
Proplet cant angle (DEG.) Default =0.0 
Free stream MACH number. Default - U.O 
Advance ratio 

Snit e L^t“(s“G/FT-3) Default -002378 
Free stream velocity (FT/SEC) 
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DATA UNITS: 


GEOM(RNOSE) , GEOM(BCHORD) , GEOM(XVORTX) , GE0M(X34CHD) , 

GE0M(X14CHD) , GEOM(MATRIX) , GEOM(BEAMXLE) , GEOM(BMATRIX) 

- These are data members created in the Geometry Generator 
module. They contain information related to airfoil sections. Refer 
to GEOGEN module for detailed description. 

COEFF(CDRl), C0EFF(CDR2) ,. . . data members containing lift, drag 
and moment coefficients of each airfoil section. Refer to airfoil 
loading module, for example, NACA 16 for detailed description. 

AIRCRFT(FLOWQRT) - This is a multi-record member containing 
the three velocity components of inflow. 

OUTPUT 


DATA UNIT: 


STRUC( SURFLOAD) - This is a multi -record member containing the 
surface loading on the 1/4-chord line at locations where structural 
modules require the aerodynamic loading. This is to be used in the 
structure BEAM module. 


STRUC(X14CHD) - This is a multi-record member which contains 
the global coordinates of points on the 1/4-chord line intercepting 
the sections normal to elastic axis. It is created for the use of 
the BEAM module. 
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PRESSURE LOADING MODULE (PLD) 

PURPOSE: TO INTERPOLATE THE SURFACE PRESSURE FOR ACOUSTIC 

CALCULATIONS 

INPUT 

USER PARAMETERS: 

B Blade radius in meters 

VF Free stream velocity in m/sec 

MZ Free stream Mach number 

OMEGA Rotational speed in rad/sec 

ATRAN(I) Constant A used to characterize the pressure profile on 
each airfoil section (Figure 3.4-1). (def. =.02) 
BTRAN(I) Constant B used to characterize the pressure profile on 
each airtoil section, (def. =.999) 

DATA UNITS: 

COEFF(CP) - multi -record member containing the pressure 
coefficient for each airfoil section. This member is created by 
airfoil loading module TRANSEP. Detailed description can be found 
in the I/O discussion of TRANSEP. 

GRID(PSI) - multi-record member containing the psi function of 
each peripheral points on each airfoil section. This member is 
created by the rotating blade module (RBS). Detailed description 
can be found in RBS I/O discussion. 

GRID(XI2) - multi -record member containing the chorwise 
stations for a section in the elliptic coordinate system. The values 
should range from 0.0 to 2 tt. This is a required input specified 
by users. For detailed description, refer to SPN module I/O 
discusion. 

GEOM(RSLICE) , GEOM(BLADE) , GEOM(BLADEL) - These are data 
member created by GEOGEN module. Refer to the GEOGEN for detailed 
description. 

PROP(CLD) - multi -record member containing the design lift 
coefficients for each airfoil section. 

PROP(CLZM) - multi-record member containing the lift 
coefficient and Mach number for each mid-section of airfoil 
calculated in PROPCHG module. 

OUTPUT 

PLD (LOADS) - multi-record table created for the use of 
acoustic modules. It contains the pressure loading on each section 
along the propeller span. 
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DATA UNITS: 


BEAM(SPINP) - This is a three record member containing the 
index and the three unit vectors which defines the spin plane. 


BEAM(BOUNDRY) - This is a one record member containing the 
control flags which specify the boundary conditions for each 
spanwise station. 


STRUC (BPROP) , STRUC(SHRCNTR) - These are the two members 
created by the Geometry Generator module (GEOGEN) which c0 ^ a ] s J 
section properties and locations of shear centers. Refer to GEOGEN 
for detailed description. 


STRUC(X14CHD), STRUC(SURFLOAD) - These are the two members 
created by the Performance module (PROPCHG). They contain locations 
of the 1/4-chord line that intercepts the structure sections, and 
the surface loading. Refer to PROPCHG for detailed description. 


OUTPUT . 


DATA UNITS: 


RESTART (DELXYZ) - This is a multi -record member which 
-ontains the deflection and change in twisting angle for each 
section considered. This member is output for the purpose of 
finding a converged blade shape in multiple-pass mode operation. 


TRANSN2(NBKFL) - This is a transient multi-record member 
which contains information of the stiffness matrix, force array, 
etc. This member is only used internally. 


TRANSN2(NBM) - This 
contains the mass matrix. 


is a transient multi -record member which 
This member is only used internally. 
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TRANSONIC PROPELLER NOISE MODULE (TPN) 4V 

PURPOSE - TO CALCULATE THE PERIODIC ACOUSTIC PRESSURE SIGNA- 
TURE AND SPECTRUM OF A PROPELLER WITH TRANSONIC TIP 
SPEED 


INPUT 

USER PARAMETERS: 


Z 

B 

CA 

RHOA 

ERRTOL 

GLIM 

FRACOT 

IATM 

IPRINT 


ITMAX 

IUNITS 


NBLADE 

NHARM 

NTIME 

OMEGA 


Aircraft altitude (RS) , M (FT) (required if IATM-1) 
Default = 0 

Blade length from axis to tip (RS) M (FT) 

Default * 1. 

Ambient speed of sound (RS) , M/S (FT/S) 

(required if IATM=0) Default - 340.294 M/S 
Ambient density (RS) , KG/M**3 (SLUGS/FT**3) 

(required if IATM=0) Default = 1.225 
Error tolerance for root of retarded time EQ. 

(I) (Default is recommended) Default * l.E-8 
Tolerance for F(X) =0. In Newton's method 
(I) (Default is recommended) Default = l.E-5 
^ysction of time step to use in observer time 
f eren ti a tion (RS) (Default is recommended) 

Default =1.0 

Atmospheric conditions selector (I) 

0 CO and RHOO are input parameters 

1 - ATM (TMOD) has ambient conditions 
Default = 0 

Print option (I) 

0 - no print desired 

1 - input print only 

2 - output print only 

3 - input and output print 

4 - full print + plot tape 
Default = 3 

Maximum no. of iterations for Newton's method (I) 
Default is recommended) Default ■ 10 
System of units indicator (A2 or A7) 

2HSI SI UNITS 

7HENGLISH ENGLISH UNITS 

Default = 2HSI 

Number of blades on propeller (I). Default = 4 
No. of spectral levels output (I). Default = 16 
No. of points used for time signature. NTIME 2 2*NHARM 2 
Default = 100 

Angular velocity of the blade (RS) , Radians/sec. 
Default = 225. 


PSI0 Initial azimuth angle of blade (RS) , radians 

Default = 0. 

PLTID 8 letter ID written on 1st record of plot tape 
(A8) Default = 3HTPN 
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ORIGINAL PAGE IS 
OF POOR QUALITY 


THETAR 

RX 

MZ 


Root pitch change (RS), radians Default = 0. 

Source Radius for output, RE B (RS), (Required if IOUT 
1) Default * 10. 

Aircraft Mach number (RS) , Default * .3 
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SUBSONIC PROPELLER NOISE MODULE (SPN) 

PURPOSE: TO CALCULATE THE PERIODIC ACOUSTIC PRESSURE SIGNATURE 

AND SPECTRUM OF A PROPELLER WITH SUBSONIC TIP SPEED. 

INPUT 

USER PARAMETERS: 


ALT 

BTIP 

CO 

ERRTOL 

GLIM 

IATM 

IDPDT 

IPRINT 


ITMAX 

IUNITS 

NB 

NS 

NT 

METHOD 

OMEGA 


Aircraft altitude M (FT) Default = 0. 

Blade radius; length from axis to tip M (FT) 

Default =1. 

Ambient speed of sound M/S (FT/S) Default = 340.294 M/S 

Error criteria; root of retarded time EQ.- Default 

is recommended Default = l.E-8 

Tolerance check for Newton's Method - Default 

is recommended Default = l.E-5 

Atmospheric conditions selector 

0 - CO and RHOO are input parameters 

1 - ATM(TMOD) has ambient conditions Default = 0 
Blade loading selector 

0 - Blade loading is steady 

1 - Blade loading is time dependent Default = 0 
Print option 

0 - No print desired 

1 - input print only 

2 - output print only 

3 - input and output print 

4 - full print + plot tape 
Default =3 

Maximum no. of iterations for Newton's method - 

Default is recommended Default = 10 

System of units indicator 

2HSI SI Units 

7HENGLISH English Units 

Default = 2HSI 

number of blades on propeller 
Default = 4 

No. of spectral levels output 
Default = 16 

No. of points used for time signature 
4 < 2*NS < NT 
Default = 100 

Computational method selector 

1 - full blade formulation 

2 - mean surface approximation 

3 - compact source approximation 
Default = 1 

Angular velocity of the blade Radians /Sec 
Default = 225. 
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PSIO 

RHOO 

RPC 

RX 

VF 


Initial azimuthal angle of blade in 
degrees Default = 0 . 

Ambient Density 
KG/M**3 (slugs/FT**3) 

Default = 1.225 
Root pitch change 
degrees 
Default ■ 0. 

Source radius for output, re BTIP 
Default = 10. 

Aircraft velocity M/S (FT/S) 

Default = 100. 
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3.5 SYSTEM RUNNING PROCEDURE 

This section outlines the procedure required to run the GAPAS system. 
The procedure can be separated into three steps: program compilation, 

object modules linkage, and execution. 

Figure 3.5-1 shows the job control statements required to compile all 
the functional modules. It should be pointed out that GAPAS is developed 
to run on the CDC CYBER 175 or 750, NOS operating system. Any attempt to 
run the system under another operating procedure is likely to result in 
system errors. Furthermore, it is assumed that a FORTRAN IV compiler is to 
be used. The six cards from /JOB to DELIVER. B31, are job control cards, 
and are therefore required only if the NASA Langley CDC computer system is 
used. The following three GET cards are to retrieve all the functional 
module source code stored on disk as permanent files. Permanent file XM is 
the main program driver necessary when the overall system is linked. Next, 
the FIN and SAVE cards are used to compile each module, and the object 
module thus obtained is saved as permanent file. On the FTN card, L=0 
means that no compiler output listing is desired, and B=ATML means that the 
object module generated resides on a file named ATML. Finally, /EOF is the 
end-of-file card. 

Figure 3.5-2 shows the input control statement stream required to link 
the overall GAPAS system. Again, the first six cards are job cards for the 
NASA Langley computer system. GET, EXECLIB is the control card that 
retrieves the ANOPP executive system currently residing in the user 

library. GEOL, JUMPL, are object modules for each functional module. 

GET,SEGDIR retrieves the segment loader directive file for the construction 
of an overlay executable program (Figure 3.5-3). GAPAS is a large program 
and requires overlay techniques to meet the main core memory limitation. 

The current version of GAPAS has employed the segment overlay for reasons 
of flexibility. SEGDIR contains loader directives which instruct the 
loader as to how the overall program should be overlayed. The LDSET card 
sets the load options. LIB=EXECLIB specifies that EXECLIB file is a user 
library, PRESET=ZER0 pre-sets core everywhere to zero; and MAP=SB/MAPLIST 
puts the load map in a file named MPLIST. The SEGLOAD card invokes the 
segment loader which takes directives from the file SEGDIR. The 
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executable, thus constructed, will reside on a file named ANOPTMP. The 

actual loading is done by invoking the LOAD ( XML, ATML, ) command. The 

NOGO statement allows the loader to complete the loading. Finally, the 
temporary executable ANOPTMP is saved as a direct file by using the DEFINE 
and COPY statements. 

Figure 3.5-4 shows the job control statements required to execute 
GAPAS. ATTACH, GAPASX retrieves the GAPAS executable which is a direct 
file. GET, SR3DAT retrieves the input file for the NASA Lewis SR-3 
propeller, which contains a GAPAS control statement stream specifying the 
type of run to be made. LDSET presets core to zero. GAPASX (SR3DAT) 
executes the program with input file residing in SR3DAT. Upon completion, 
the output file which resides on TAPE4 is saved as a permanent file. 
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/JOB 
/NOSEQ 
GAPAS, 7777. 

USER, 977603 , UMIRLQ3 
CHARGE, 10326 7, LRC/ 

DELIVER. B31 FRANKLIN 
GET XM. 

GET , ATM , GEOGEN , JUMPER , NACA16 , TRANSEP . 
GET , PROPCHG , BEAM, El GP AC , PLD , TPN , SPN. 
FTN , I-XM , L-0 , B-XML . 

SAVE, XML. 

FTN , I -ATM , L-0 , B-ATML 
SAVE , ATML . 

FTN , I -GEOGEN , L-0 , B-GEOL . 

SAVE ,GEOL. 

FTN , I- JUMPER , L-0 , B-JUMPL . 

SAVE, JUMPL. 

FTN , I-NACA1 6 , L-0 , B-NACAL . 

SAVE , NACAL . 

FTN , I -TRANSEP , L-0 , B-TRANL . 

SAVE , TRANL . 

FTN , I -PROPCHG , L-0 , B-PROPL. 

SAVE.PROPL. 

FTN , I-BEAM , L-0 , B-BEAML . 

SAVE , BEAML . 

FTN , I-EIGPAC , L-0 , B EIGL. 

SAVE, El GL 

FTN , I -PLD , L-0 , B-PLDL . 

SAVE , PLDL . 

FTN , I-TPN , L-0 , B-TPNL . 

SAVE.TPNL. 

FTN , I-SPN , L-0 , B-SPNL . 

SAVE , SPNL. 

/EOF 


Figure 3.5-1. Compilation of GAPAS Functional Modules 
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/JOB 
/NOSEQ 
GAP A*? Till 

USER ,9776030, UMIRLQ3 . 

CHARGE, 103267, LRC. 

DELIVER. B31 FRANKLIN 
GET.EXECLIB. 

GET , GEOL , JUMPL , NACAL , PROPL , BEAML , EIGL . 

REMIND , GEOL , JUMPL , NACAL , PROPL , BEAML , EIGL . 

GET , XML , ATML , TRANL , PLDL , SPNL , TPNL . 

REWIND , XML , ATML , TRANL , PLDL , SPNL , TPNL . 

GET, SEGDIR. 

REWIND, SEGDIR. 

LDSET (LIB=EXECLIB , PRESET=ZERO ,MAP-SB /MAPLST) . 

SEGLOAD , B=ANOPTMP , LO-DT , I-SEGDIR. 

LOAD ( XML , EIGL , ATML , GEOL , JUMPL , NACAL , TRANL , PROPL , BEAML , PLDL , SPNL , TPNL 
NOGO. 

REWIND, ANOPTMP. 

REWIND, MAPLST. 

DEFINE, GAPASX. 

COPY , ANOPTMP , GAPASX . 

REPLACE, MAPLST. 


Figure 3.5-2. Linking 6APAS 
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:t:»******:«**4:«***4*:t*4*:t*4*:t*:****:t***:«*:*:****:t*:t**:*:t*:**:«***:t***** 
* * 

* THE FOLLOUING INCLUDES AND GLOBALS ARE FOR LEVEL 0 (ROOT) * 

* * 
stt************************************************************* 



INCLUDE 

DECODE 3 


INCLUDE 

ENDFILE 


INCLUDE 

GETP 


INCLUDE 

MfIGETU 


INCLUDE 

NMOPUS 


INCLUDE 

HNPUTU 


INCLUDE 

NNREU 


INCLUDE 

PUTP 


INCLUDE 

REUND 


INCLUDE 

SKIP 


INCLUDE 

XCA 


INCLUDE 

XCATRA 


GLOBAL 

CMNC 


GLOBAL 

UCON 


6L0BAL 

XANOPP 


GLOBAL 

XBSC 


GLOBAL 

XCAC 


GLOBAL 

XCKRS 


GLOBAL 

XCRC 


GLOBAL 

XCS 


GLOBAL 

XCSFH 


GLOBAL 

XCSPC 


GLOBAL 

XCVT 


GLOBAL 

XDBNC 


GLOBAL 

XDSNC 


GLOBAL 

XDTNC 


GLOBAL 

XPOTH 


GLOBAL 

XROOT 


GLOBAL 

XSPT 

MAIN 

INCLUDE 

XN 

XCO 

INCLUDE 

XIFCRD 

XCO 

INCLUDE 

XIFCRS 

XCO 

INCLUDE 

XPACX 

XCO 

INCLUDE 

XPAINT 

XCO 

INCLUDE 

XPARD 

XCO 

INCLUDE 

XPARS 

XCO 

INCLUDE 

XPR 

XUFNG2 

INCLUDE 

XSEVM2 




♦ * 

* THE FOLLOUING INCLUDES AND GLOBALS ARE FOR TREE * 

* SEGMENTS IN LEVEL 1. * 

* « 


iM**************************************:**********:**:******:****:* 

Figure 3.5-3. Overlay Structure 
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FHP1 

FHP1 

FMP1 

FHP1 

FHP1LA 

FNP1LA 

FHP1LA 

FHP1LA 

FHP1LA 

FN1 

FH1 

FH1 

FM1 

SPLS 

SPLS 

SPLS 

FH1LA 

FMtLA 

FM1LA 

FN1LA 

FM1LA 

HRNLA 

TPNLA 

RBALA 

RBSLA 

SPNLA 

PRTIA 

XBSLA 

XCG 

XCG 

XCG 

XCGFUL 

XCGFUL 

XCK 

XCL 

XCL 

XCL 

XCL 

XCL 

XCL 

XCL 

XCL 

XCL 

XCL 

XCL 

XCL 

XCL 

XCL 

XCL 

XCL 


INCLUDE FHP2 
INCLUDE FNP3 
INCLUDE FNP4 
INCLUDE FNP5 
GLOBAL FNP1LA 
EQUAL FNP2LA 
EQUAL FNP3LA 
EQUAL FMP4LA 
EQUAL FMP5LA 
INCLUDE FH2 
INCLUDE FN3 
INCLUDE FN4 
INCLUDE FH5 
INCLUDE ALEV 
INCLUDE VPUL 
INCLUDE BBPNL 


GLOBAL 

FN1LA 

EQUAL 

FN2LA 

EQUAL 

FN3LA 

EQUAL 

FN4LA 

EQUAL 

FN5LA 

GLOBAL 

HRNLA 

GLOBAL 

TPNLA 

GLOBAL 

RBALA 

GLOBAL 

RBSLA 

GLOBAL 

SPNLA 

GLOBAL 

PRTLA 

GLOBAL 

XBSLA 

INCLUDE 

XML 

INCLUDE 

XTB 

INCLUDE 

XTL 

INCLUDE 

XDUHDR 

INCLUDE 

XFMTQ 

INCLUDE 

XEN 

INCLUDE 

XCABST 

INCLUDE 

XCACLO 

INCLUDE 

XCAI 

INCLUDE 

XCAMXX 

INCLUDE 

XCANCS 

INCLUDE 

XEVTBD 

INCLUDE 

XRTAHU 

INCLUDE 

XRTBAD 

INCLUDE 

XRTBCS 

INCLUDE 

XRTBLR 

INCLUDE 

XRTCAL 

INCLUDE 

XRTCSS 

INCLUDE 

XRTDAT 

INCLUDE 

XRTEND 


INCLUDE XRTLRF 
INCLUDE XRTLSA 


Figure 3.5-3. Overlay Structure 


(Continued) 
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XCL 

INCLUDE 

XRTLSE 

XCL 

INCLUDE 

XRTODB 

XCL 

INCLUDE 

XRTPIN 

XCL 

INCLUDE 

XRTSA7 

XCL 

INCLUDE 

XRTSAR 

XCL 

INCLUDE 

XRTSCA 

XCL 

INCLUDE 

XRTSCG 

XCL 

INCLUDE 

XRTSCK 

XCL 

INCLUDE 

XRTSCO 

XCL 

INCLUDE 

XRTSCR 

XCL 

INCLUDE 

XRTSDA 

XCL 

INCLUDE 

XRTSDR 

XCL 

INCLUDE 

XRTSDT 

XCL 

INCLUDE 

XRTSDU 

XCL 

INCLUDE 

XRTSEN 

XCL 

INCLUDE 

XRTSER 

XCL 

INCLUDE 

XRTSEV 

XCL 

INCLUDE 

XR7SEX 

XCL 

INCLUDE 

XR7SFN 

XCL 

INCLUDE 

XR7SG0 

XCL 

INCLUDE 

XR7SIF 

XCL 

INCLUDE 

XR7SLD 

XCL 

INCLUDE 

XR7SL1 

XCL 

INCLUDE 

XR7SL2 

XCL 

INCLUDE 

XR7SNL 

XCL 

INCLUDE 

XR7SPA 

XCL 

INCLUDE 

XR7SPL 

XCL 

INCLUDE 

XR7SPR 

XCL 

INCLUDE 

XR7SPU 

XCL 

INCLUDE 

XR7SRE 

XCL 

INCLUDE 

XR7SSS 

XCL 

INCLUDE 

XR7S7A 

XCL 

INCLUDE 

XR7S7I 

XCL 

INCLUDE 

XR7S7L 

XCL 

INCLUDE 

XR7SUL 

XCL 

INCLUDE 

XR7SUP 

XCL 

INCLUDE 

XR7SYN 

XCL 

INCLUDE 

XR77C 

XCL 

INCLUDE 

XR7U 

XCL 

INCLUDE 

XR7VCS 

XCL 

INCLUDE 

XSEVBD 

XCL 

INCLUDE 

XSEVCK 

XCL 

INCLUDE 

XSEVLE 

XCL 

INCLUDE 

XSEVSC 

XCL 

INCLUDE 

XSEVSN 

XCL 

INCLUDE 

XSEVSR 

XCSLA 

GLOBAL 

XCSLA 

XPL 

INCLUDE 

XAR 

XPL 

INCLUDE 

XA7 

XPL 

INCLUDE 

XDA 

XPL 

INCLUDE 

XD7 


Figure 3.5-3. Overlay Structure (Continued) 
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XPL 

INCLUDE 

XPU 

XPL 

INCLUDE 

XSS 

XPL 

INCLUDE 

XT1 

XRT 

INCLUDE 

XEVTBD 

XRT 

INCLUDE 

XRTAMU 

XRT 

INCLUDE 

XRTBAD 

XRT 

INCLUDE 

XRTBCS 

XRT 

INCLUDE 

XRTBLR 

XRT 

INCLUDE 

XRTCAL 

XRT 

INCLUDE 

XRTCSS 

XRT 

INCLUDE 

XRTDAT 

XRT 

INCLUDE 

XRTEND 

XRT 

INCLUDE 

XRTTC 

XRT 

INCLUDE 

XRTLRF 

XRT 

INCLUDE 

XRTLSA 

XRT 

INCLUDE 

XRTLSE 

XRT 

INCLUDE 

XRTODB 

XRT 

INCLUDE 

XRTPIN 

XRT 

INCLUDE 

XRTSAR 

XRT 

INCLUDE 

XRTSAT 

XRT 

INCLUDE 

XRTSCA 

XRT 

INCLUDE 

XRTSCG 

XRT 

INCLUDE 

XRTSCK 

XRT 

INCLUDE 

XRTSCO 

XRT 

INCLUDE 

XRTSCR 

XRT 

INCLUDE 

XRTSDA 

XRT 

INCLUDE 

XRTSDR 

XRT 

INCLUDE 

XRTSDT 

XRT 

INCLUDE 

XRTSDU 

XRT 

INCLUDE 

XRTSEN 

XRT 

INCLUDE 

XRTSER 

XRT 

INCLUDE 

XRTSEV 

XRT 

INCLUDE 

XRTSEX 

XRT 

INCLUDE 

XRTSFN 

XRT 

INCLUDE 

XRTSGO 

XRT 

INCLUDE 

XRTS1F 

XRT 

INCLUDE 

XRTSLD 

XRT 

INCLUDE 

XRTSL1 

XRT 

INCLUDE 

XRTSL2 

XRT 

INCLUDE 

XRTSML 

XRT 

INCLUDE 

XRTSPA 

XRT 

INCLUDE 

XRTSPL 

XRT 

INCLUDE 

XRTSPR 

XRT 

INCLUDE 

XRTSPU 

XRT 

INCLUDE 

XRTSRE 

XRT 

INCLUDE 

XRTSSS 

XRT 

INCLUDE 

XRTSTA 

XRT 

INCLUDE 

XRTSTI 

XRT 

INCLUDE 

XRTSTL 

XRT 

INCLUDE 

XRTSUL 

XRT 

INCLUDE 

XRTSUP 


Figure 3.5-3. Overlay Structure (Continued) 
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XRT 

INCLUDE 

XRTSYN 

XRT 

INCLUDE 

XRTU 

XRT 

INCLUDE 

XRTVCS 

XRT 

INCLUDE 

XSEVBD 

XRT 

INCLUDE 

XSEVCK 

XRT 

INCLUDE 

XSEVLE 

XRT 

INCLUDE 

XSEVSC 

XRT 

INCLUDE 

XSEVSN 

XRT 

INCLUDE 

XSEVSR 

XRTLA 

GLOBAL 

XRTLA 

XSLFBD 

GLOBAL 

XSLF 

XSLFBD 

INCLUDE 

XDR 

XSLFBD 

INCLUDE 

XLD 

XSLFBD 

INCLUDE 

XUN 

XUP 

GLOBAL 

XUPC 

NACA14 

INCLUDE 

ATN( 


* * 

* THE FOLLOWING TREE DEFINES THE ONLY SEGMENT IN LEVEL 0 * 

* * 

*********** *********************************:»:** ^t**;****:******** 

TREE HAIN-(TMERR2.MMERR2.XXNHG2,XXFMG2.XUFNG2.FHNMG2 .DSNER2 , 

.XCO) 

* * 

THE FOLLOUING TREE SEGMENTS ARE FOR LEVEL 1. ■* 


* 

(NOTE. 

THERE IS ONLY ONE SEGMENT IN LEVEL 0.) * 

¥ 

************************************************** *******.£*;££.'£ 
LEVEL 

FMP11 

TREE 

FMP1-FNP1LA 

FH11 

TREE 

FH1-FN1LA 

HRN1 

TREE 

HRN-HRNLA 

PR0P1 

TREE 

PROP 

TPN1 

TREE 

TPN-TPNLA 

RBA1 

TREE 

RBA-RBALA 

RBS1 

TREE 

RBS-RBSLA 

SPN1 

TREE 

SPN-SPNLA 

PRT1 

TREE PRT-PRTLA 

PROPP 

TREE 

SPLS-(FMP11 .HRNI.PROPI.TPNI .RBA1.RBS1 .SPN1.PRT1 ) 


TREE 

GEOGEN 

TREE 

JUMPER 

TREE 

NEUMANN 

TREE 

EPPLER 

TREE 

TRANSEP 

TREE 

CLARKY 

TREE 

NACA14 

TREE 

NACA44 

TREE 

NACA45 

TREE 

PROPCHG 

TREE 

PROPALJ 

Figure 

3.5-3. 
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TREE STRUC-(BEAN,EIGPAC> 

TREE PID 
TREE ATM 
TREE XBS-XBSLA 

TREE XCGFUL- <XUP-(XUPCHG .XUPXFR.XUPSYN ) ,XCL .XCG .XSIFBD) 

TREE XCK 

TREE XEV 

TREE XHERR 

TREE XPL 

TREE XRT-XRTLA 


4 * 

* THE FOLLOUING LEVEL IS FOR THOSE LDSA CONHON BLOCKS USED * 

=» BY FUNCTIONAL MODULES OR EXECUTIVE MODULES THAT RESIDE * 

* IN THE ROOT LEVEL 0. * 

:* * 


:tt**************************************4*4*4*4*4*4*4*4*4*44*4* 

LEVEL 

TREE XCSLA 
END XN 


Figure 3.5-3. Overlay Structure (Continued) 
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/JOB 

/NOSEQ 

GAP AS , T2000 . 

USER, 977603C,UMIRLQ3 
CHARGE, 103267, LRC. 
DELIVER. B31 FRANKLIN 

ATTACH , GAP ASX . 
GET,SR3DAT. 

LDSET (PRESET = ZERO) 

GAP ASX (SR3DAT) 

REWIND , TAPE4 . 

REPLACE, TAPE 4 
SRUCOMP . 

DAYFILE ,DFILE. 

REP LACE, DFILE. 

EXIT. 

SRUCOMP . 

DAYFILE, DFILE. 

REP ALCE, DFILE. 

REWIND, TAPE 4 . 

REPLACE, TAPE 4 
/EOF 


Figure 3.5-4. Execution of GAPAS 
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3.6 INPUT FILE DESCRIPTION 

GAPAS input file contains a set of internally supported control 
statements that are processed sequentially by the executive part of the 
system. Different statements perform different tasks by activating various 
system routines. These statements can be placed in any way relative to 
each other, as long as they represent a meaningful sequence to the users. 

To prepare a primary input stream, the following statements must be 
incl uded. 

ANOPP S 

STARTCS $ 

S 

$ 

ENDCS $ 

Figure 3.6-1 shows the input file for NASA Lewis SR-3 propeller 
operating at Mach number = 0.8, advance ratio = 3.06, and sea level 
altitude. The first two cards (ANOPP, STARTCS) and the last card (ENDCS) 
must be included. These cards are necessary to set up a primary input 
stream. In ANOPP, the statement CKPNT=CPNT13 option specifies that a 
subsequent restart run is desired and that the run environment is saved in 
a file named CPNT13. Just prior to the EXECUTE ATM, PARAM ALTUDE=0.0 $ is 
inserted, which specifies the altitude of flight for atmospheric properties 
calculations. This statement is followed by three PARAM statements that 
specify various input parameters for the geometry generator. UPDATE is 
used to create a data unit named GEOM which possesses three data members 
named RSLICE, XCOOR, and MSLICE. These members specify the output spanwise 
stations in GEOM(RSLICE) , chordwise stations in GEOM(XCOOR), and 
coordinates of peripheral points of sections normal to the pitch change 
axis in GEOM(MSLICE) . To close out the data unit, an END* statement is 
used. These are all the input required for the geometry generator. With 
these data, the module is executed by issuing EXECUTE GEOGEN S. 

The next module to be executed is the Aircraft Flowfield module, 
JUMPER. The required input is either satisfied by data units already 
created by the GEOGEN, or by user parameters and data units to be created 
by users. Here a mixture of PARAM and EVALUATE are used to establish 
values for user parameters. PARAM is used to input values to user 


01 - 168-86 


3-103 


ANGPP CKPNT =CPNT 1 3 JECHO=.TR!JE. * 
STARTC3 * 


* * 

* INPUT FILE FOR NASA SR-3 PROPELLER OPERATED * 

* UNDER FOLLOWING CONDITIONS MACH=0.8 * 

* ADVANCE RAT I 0=3. 06 ALTITUDE=0.0 * 

* * 

* * 

* EXECUTE ATMOSPHERIC MODULE * 

* * 


$$*$$*$$$*$$**$$ ***$*$$ $*$*$$***$$$$$$ $ $****$$$ $$*$$$ 
param ALTUDE=0. 0 * 

EXECUTE ATM * 

* * 

* EXECUTE GEOMETRY GENERATOR « 

* % 

PARAM IGLOBE=Oi I SPACE* 1 , NIN=13t I0PT=10, MAXIT=7, ISTART=0 
PARAM BETA3Q*-. 61 EPSSHR=. 0005 EM0D=1.59E+7 F'OISS=. 334 DENS* 
PARAM R=12. 25 * 

UPDATE NEWU=GEOM, SOURCE** * 

— ADDR OLDM=*» NEWM=RSLICE» F0RMAT=0 * 

13 * 

3.00 3.35 4.65 5.45 6.20 7.00 7.75 
8.50 9.20 9. 85 10.50 11.20 11.90 * 

-ADDR OLDM=*» NEWM=XCOOR, F0RMAT=0 * 

25 % 


1.0 0.95 0.9 0.85 0.8 0.7 0.6 0.5 

0.4 0.3 0.25 0.2 0.15 0.1 0.075 0.05 0.03 

0.025 0.02 0.015 0.01 0.006 0.003 0.001 0.0 

-ADDR GLDM=*> NEWM=MSLICE, F0RMAT=0 * 


53 * 

1 . 000000 
.953110 
.917160 
. 876240 
. 335230 


O . 000000 
.014973 
. 028795 
.041627 
. 054010 


0.000000 
0 . 000000 
0.000000 
0.000000 
0.000000 


0 . 000000 
0.000000 
0.000000 
0.000000 
0.000000 


% 

% 

* 

% 

« 


* 


Figure 3.6-1. Input File for NASA Lewis SR-3 Propeller 
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END* * 

EXECUTE GEOGEN * 

4444444444 44444444444444444444444444444444 
4 * 

4 EXECUTE JUMPER MODULE * 

4 * 

44444444444444444444444444444444444444444444444444444 

PARAM MACH-O. S AJ-3.06 R-12.25 PI-3.14159 4 

EVALUATE VCOM=MACH*CO 4 

EVALUATE RPM=VCGM*6C. *12. / < AJ*2. *R> * 

PAPAM NSYMET-0 » NWING-O. NINFLQ-O* NAZIMU-1. NSLICE-13 
PARAM NPOINT-1. NCALC-0 i NLIST-1, ITMAX-20 4 
PARAM ALPHA-O. 0» YAW-O. 0» R-12.25 4 

PARAM XREF-24.5, ERR— 3.0 * 

UPDATE NEWU-AIRCRFT, SOURCE-* 4 


-ADDR OLDM-* . 

NEWM-BODY, 

FORMAT-O 4 


30 4 

1 

9 

0 

s 

. 29590 

0 . 00000 

0.00000 

$ 

. 29590 

0 . 00000 

0 . 00000 

$ 

. 29590 

0.00000 

0.00000 

s 

. 29590 

0 . 00000 

0.00000 

$ 

. 29590 

0.00000 

0 . 00000 

* 

. 29590 

0.00000 

0.00000 

s 

. 29590 

0 . 00000 

0.00000 

* 

.29590 

0.00000 

0.00000 

* 


4 


END* 4 

EXECUTE JUMPER 4 

4 **■»*■»***********************************■*■****'*'*' ,, " ,, " ,, '■ ,, '^ 
4 * 

4 EXECUTE NACA16 * 

4 * 

4 ********************************************'^^'^^'^"^^^ 
UPDATE NEWU-PROP, SOURCE-* 4 


Figure 3.6-1. Input File for NASA Lewis SR— 3 Propeller (Continued) 
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-ADDR OLDM=*, NEWM=CLD, F0RMAT=5H1RS 4 4 

- 0 . 20 * 

- 0.01 * 

0.09 4 

0.14 4 

0.17 4 

0.19 4 

0.21 4 

0 . 23 4 

0.24 4 

0.24 4 

0.23 4 

0.22 4 

END* 4 


PAR AM liACH*0.8> IAIR23=1 4 
PARAM NOUT » i * 

L2 CONTINUE 4 
PARAM CLL=0.2 4 

PARAM NALPHA=4 4 
LI CONTINUE 4 
EXECUTE NACA16 4 
PARAM CLL = CLL * 0.11 4 
PARAM NALPHA = NALPHA - 1 4 

IFCNALPHA .NE. 0) GOTO LI 4 
PARAM NOUT * NOUT +1 4 

IF (NOUT .LT. NSLICE) GOTO L2 4 


44444444444444444444444444444444444444444444444444444 

* 4 

4 EXECUTE CHANG-SULLIVAN MODULE 4 

* 4 
44444444444444444444444444444444444444444444444444444 

PARAM NB=3, NUMEL=12, MPR0P=13, INDUC=1 4 
PARAM I D2=0 i LWRITE=0, ID=0 4 
PARAM AJ=s3.06, R=12.25 4 
EXECUTE PROPCHG 4 


44444444444444444444444444444444444444444444444444444 

* 4 

4 EXECUTE STRUCTURE BEAM MODULE 4 

* 4 
44444444444444444444444444444444444444444444444444444 


Figure 3.6-1. Input File for NASA Lewis SR-3 Propeller (Continued) 
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PARAM IPR0B=1 PL=0. 0 PU» 10000000. 0 NR=6 * 

PARAM EPS*. 0001 EPS 1 = . 00 1 6=0.0 EIGEN=. FALSE. INDEX-1 S 
PARAM ISTDYM=li I0PLIN=0. ITERMX=20» ZDELTA=.OU01 * 
UPDATE NEUU=BEAMi SOURCE =* * 

-ADDR OLDM=*t NEWM=SPINP. F0RMAT=6HI ■> 3RS* $ 


9000 

0 - 0 

0.0 

0 . 0 

s 

900 1 

0 . 0 

1.0 

0 . 0 

* 

9002 

i . 0 

0.0 

0.0 

s 


-ADDR QLDM=*» NEWM=BOUNDRY , F0RMAT=4H6I S * 

1 1 1 1 1 1 * 

END* * 

EXECUTE STRUC * 

CPI CKPNT STOP * 

$5*S$*?5**$$*S*$S***$*$®*®*®®***®®*****®®®®®®**®®*®®®® 

* * 

* SECOND AND THIRD ITERATIONS * 

% * 

PARAM BETASQ=0. 0 MAXIT=2 * 

L3 CONTINUE $ 

PARAM I START = I START + 1 * 

EXECUTE GEOGEN * 

EXECUTE JUMPER * 

EXECUTE PROPCHG * 

EXECUTE STRUC * 

CP2 CKPNT * 

IF ( ISTART . LT . 2) GOTO L3 

$***$**$S*S*$<***$$***®®*®®*®**®®®*®*®***®®®*®***®®*® 

* J 

% EXECUTE BLADE SHAPE MODULE * 

« * 

PARAM B=.31115* IUNITS-2HS I . IPRINT=3, ZSLOPE*. FALSE. , WEIGHT* 
UPDATE NEWU=GRID SOURCE=* * 

-ADDR NEWM=XI2 OLDM=* F0RMAT=4H*RS* MNR=1 * 

0.0 . 26 IS .5236 . 7S54 1.0472 1.309 1.5708 
1.3326 2.0944 2.35619 2.61799 2.S7797 3.1415926 

3.40339 3.66519 3.92699 4. 1S379 4.45059 4.71239 

4.97419 5.23599 5.49779 5.75959 6.02139 6.2S319 t 

-ADDR NEWM=PSI OLDM=* F0RMAT=4H*RS* MNR=1 * 


.FALSE 


Figure 3.6-1. Input File for NASA Lewis SR-3 Propeller (Continued) 



0 . * 

END-* * 

EXECUTE PBS * 

****$***$$$*S*****$$S$***$*$$*$*$$$$$*$ 4 $ S4$ 5j 4$ j $f $*$ 
* 

* EXECUTE PRESSURE LOADING MODULE 

* 

$***$*$******$«$**$*$*$$******$ $«$$$$$$$$$$$$$$<$$«$$$$ 


PARAM 

ATRAN*. 0005, 

.0005, 

.0005, 

.0005, 

.0005, 



.0005, 

.0005, 

.0005, 

.0005, 

. 0005 

S 

PARAM 

BTRAN*. 9999, 

. 9999 , 

. 9999, 

.9999, 

.9999* 



. 9999 , 

. 9999 , 

. 9999. 

. 9999 , 

„ 9999 

% 


PARAM I DBANK* 1 * 

PARAM NBLADE= 8 , MZ=0.8, Z=0.0 B=.311 15 * 

EVALUATE RH00=RHGA*515. 240 * 

EVALUATE C0=C0*.304S * 

EVALUATE VF=VCOM*. 3048 t 
EVALUATE OMEGA*RPM*PI /30. 0 * 

PARAM IPRINT*4, INF0=1 * 

PARAM BT IP=Bi NS=30, I ATM=0, NB=NBLADE, RPC=0.0 * 

PARAM ALT=Z CA=CO NHARM-NS RHOA=RHOO * 

EVALUATE PGWREF* RHOO * B**5 * GMEGA** 3 < 

EVALUATE POWER = 4. *CP *POWREF /(PI**3) * 

EVALUATE PKW=P0WER*0. 001 /NBLADE * 

PARAM THRUST=495.S7 TIPSP=689.69 * 

EXECUTE PLD * 

UPDATE NEWU=OBSERV SOURCE** * 

-ADDR GLDM=* NEWM=COORD FORMAT *4H3RS< * 

-1.219 0.1020 -0.00953 * 

END* * 

EXECUTE TPN * 

ENDCS * 


Figure 3.6-1. Input File for NASA Lewis SR-3 Propeller (Continued) 
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parameters directly. EVALUATE is used to establish the values by using 
existing user parameter values. Following is a data unit named AIRCRFT to 
be created by using an UPDATE statement. Only one member is required to be 
input. This member contains the coordinates describing the geometry of the 
nacelle housing the propeller. At the end, END* signals the termination of 
the input data. This is followed by an execution command, namely, EXECUTE 
JUMPER $ 

After GEOGEN and JUMPER are executed, the drag polar is constructed by 
executing NACA16 data bank repeatedly at various angles of attack for each 
airfoil section. This requires conditional/branching control statements, 

IF( ) GOTO LABEL. In normal cases when a subsonic part of NACA16 is 

used, angle of attack is varied to obtain the drag polar. For the SR-3 
case, however, since the free-stream condition calls for transonic 
lift/drag data, AIR23 within NACA16 is employed. When AIR23 is used, the 
lift coefficient is varied to obtain the drag polar. The following is an 
excerpt from the input file. 

.... S 

L2 CONTINUE S 

PARAM CLL=0.2 $ 

PARAM NALPHA=4 S 
LI CONTINUE $ 

EXECUTE NACA16 $ 


PARAM CLL=CLL +0.11 $ 
PARAM NALPHA=NALPHA - 1 $ 
IF(NALPHA .NE. 0) GOTO LI $ 
PARAM NOUT = NOUT + 1 $ 


IF(N0UT .LT. NSLICE) GOTO L2 $ 

.... S 

.... 5 

There are two conditional loops specified by L2 and LI CONTINUE S. 

The first loop, starting from "L2 CONTINUE" to "IF ( ) GOTO L2," 

generates a drag polar for each airfoil section. The second loop, starting 

from "LI CONTINUE" to "IF ( ) GOTO LI," generates a drag polar for an 

airfoil at four different lift coefficients. 

After the drag polars are constructed, performance calculations are 
performed by EXECUTE PROPCHG. Finally, deflection due to aerodynamic 
loading and centrifugal force is determined by EXECUTE STRUC. Following 
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the structural calculation, CPI CKPNT STOP $ is issued. It signals the 
creation of a checkpoint which effectively saves the run environment in the 
checkpoint file named CPNT13. The STOP option simply Instructs the 
executive system to stop processing after the checkpoint is created. 

Up to this point, a single pass of GAPAS is completed without acoustic 
calculations. The following block of control statements simply rerun all 
the modules already discussed except NACA16. These statements constitute 
the multiple pass of GAPAS processing in which the deflected propeller is 
iterated until a converged solution is obtained, or until a specified 
number of iterations is expired. 

After either the single-pass or multiple-pass mode of operation is 
completed, acoustics calculations are ready to be performed. This requires 
the execution of two other functional modules: the rotating blade shape 
(RBS) and pressure loading (PLD) modules, which generate data to be input 
to the Acoustics modules. RBS recasts the airfoil profiles from a 
Cartesian coordinate system into an Elliptic coordinate system. PLD 
determines pressure loading on airfoil sections normal to the pitch change 
axis. Upon completion of RBS and PLD processing, the transonic propeller 
noise module is executed (EXECUTE TPN $) . 

The Hartzell 101/16 propeller which is designed to operate in subsonic 
speed has also been analyzed for the verification of GAPAS. Figure 3.6-2 
shows the input file for a single-pass mode operation. The input control 
statement stream is similar to the SR-3 case, and is not repeated here. 
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ANOPP CKPNT“CHEK31 7 JECHO».TRUE. i 
STARTCS I 

$ $ 

* INPUT FILE FOR HARTZELL-101/16 PROPELLER * 

* OPERATED UNDER FOLLOUING CONDITIONS I 

* MACH*0 .31 7 ADV RATI0 3 1.52 ALTUDE 3 10000.0 « 

i % 

$ < 

* EXECUTE ATMOSPHERIC MODULE * 

$ * 

PARAM ALTUDE 3 3048.00 $ 

EXECUTE ATM « 

i t 

i EXECUTE GEOGMETRY GENERATOR MODULE $ 

% 1 

lomMmmtmmmimmmmmmimni 
PARAM IGLOBE-O, ISPACE-1 , NIN=7, I0PT»10, NAXIT 3 6, ISTART=0 4 
PARAM BETA3Q 3 20.0, EPSSHR 3 .0005 EM0D=1.03E+7 POISS=0.33 DENS=0.0966 4 

PARAM R»53.03 IROT-O $ 

UPDATE NEUU = GEOM, SOURCE 3 * 4 

tADDR OLDM 3 *, NEUIURSLICE^ F.QRBA1 3 0 $. 

13 $ 

12.19177 13.17773 18.16369 21.14965 24.13561 27.12157, 

30.10753 33.0935 36.07946 39.06542 42.05138 45.03734, 

48.02330 % 

-ADDR OLDM«*, NEUM 3 XCOOR, FORMAT=0 4 
25 $ 


1.0 

0.95 0.9 

0.85 

0.8 

0.7 

0.6 

0.5 

0.4 

0.3 0.25 

0.2 

0.15 

0.1 

0.075 

0.05 

0.03 

0.025 0.02 

0.015 

0.01 

0.006 

0.003 

0.001 

O 

9 

o 

1 






-ADDR 

OLDM 3 * NEUM«MSLICE, 

FORMATS 

$ 





33 4 

1.000000 0.000000 0.000000 60.000000 4 

0.995000 0.020000 0.000000 60.000000 4 


0.990000 0.000800 0.000000 30.000000 4 

0.995000 0.000000 0.000000 30.000000 4 

1.000000 0.002500 0.00000030.000000 4 

2.559900 0.848000 7.165600 21.300000 0.000000 0.00000048.023300 4 

END* $ 

EXECUTE GEOGEN 4 


Figure 3.6-2. Input File for A Single-Pass Mode Operation 
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Figure 3.6 


4 EXECUTE JUMPER MODULE ! 

♦ 4 

PMRMM MACH-. 317 AJ-1.52 PI-3. 14139 4 

EVALUATE VC0H-MACH*C0 4 

EVALUATE RPM-VC0M*4O.*12./(AJ*2.»R) 4 

PARAM NSYMET-0, NUING-0, NINFLO-O, NAZIHU-1, NSLICE-1 

PARAM NPOINT-1, NCALC-0, NLIST-I, ITMAX«20 $ 

PARAM ALPHA-0.0, YAU-0.0 * 

PARAM XREF-1.0, ERR— 3.0 4 
UPDATE NEUU-AIRCRFT, SOURCE** 4 
-ADDR OLDH-*, HEUM-BODY, FORMAT *0 * 

30 * 


3 


1 9 
0.0000 
0.0000 
0.0000 
0.0000 
0.0000 
0.0000 
0.0000 
0.0000 
0.0000 

2 9 
-0.038? 
-0.0389 


0.0000 

0.0000 

0.0000 

0.0000 

0.0000 

0.0000 

0.0000 

0.0000 

0.0000 

0 

0.0000 

-0.1410 


0.0000 

0.0000 

0.0000 

0.0000 

0.0000 

0.0000 

0.0000 

0.0000 

0.0000 

-0.4207 

-0.3887 


4 


-09.2943 

-8.2309 

-3.409J 

-49.2943 

-8.9090 

0.0000 

-69.2943 

-8.230? 

3.4093 

-09.2943 

-0.2994 

0.29.90 

8.23*0? 

-69.2943 

-3.4093 

-09.2943 

0.0000 

8.9090 

-ADDR OLDH-*, 
-14.0398 0.0 

NEUH-PROP, FORMAT-O 4 
0.0 4 


0.0 0.0 « 

END* 4 

EXECUTE JUMPER 4 

EXECUTE TRAMSEP ! 


PARAM NOUT-1 NHALF-1 INOISE-O ITACT^IDERlI-0 

L2 CONTINUE 4 
PARAM ALP-2.0 4 

PARAM NALPHA-3 4 
Lt CONTINUE. .4 
EXECUTE TRANSEP 4 
PARAM ALP » ALP * 1.20 4 

PARAM NALPHA « NALPHA - 1 4 

IHNALPHA .NE. 0) 60T0 LI 4 
PARAM NOUT - NOUT * 1 4 

IF1N0UT .LT. NSLICE) GOTO 12 I 


ILAN-1 


4 


2. Input File for A Single-Pass Mode Operation (Continued) 
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EXECUTE CHANG-SULLIVAN HODULE 


4 
* 

« 

PARAH NB*3, NUHEL*12, HPROP-13, INDUC*1 * 

PARAH 102*0, LURITE*0, 18*0 IAIR23-0 . • 

EXECUTE PROPCHB 0 

0 * 

4 EXECUTE STRUCTURE BEAN HODULE * 

0 * 

PARAH IPR0B-1 PL*0.0 PU*10000000.0 HR** 4 
PARAH EPS*. 0001 EPS1-.0O1 6*0.0 EIGEH«.TRUE. IHDEX*1 * 
PARAH ISTDTH-1, IOPLIN-O, ITERHX»20, ZDELTA-.0001 * 
UPDATE HEUU*BEAH, SOURCE** 4 
-ADDR OLDH**, NEUH-SPINP, FORHAT**HI ,3RSS * 


9000 

0*0 

0.0 

0.0 

$ 

9001 

0.0 

1.0 

0.0 

$ 

9002 

t.o 

0.0 

0.0 

$ 


-ADDR OLDH**,-NEUH*BOUNDRI-,-FORNAT*4H4I -4-4 ■ 
1111110 
END* * 

EXECUTE STRUC 4 
PURGE TRANSNT,TRANSN2 4 
CPI CKPNT. STOP * 

PURGE BEAN .RESTART , STRUC * 

PARAH B*t .34*2, IUHITS*2HSI,IPRINT*3,ZSLOPE*. FALSE. ,UEI5HT*. FALSE. * 
UPDATE NEUU*GRID SOURCE** 4 
-ADDR NEUH-XI2 OLDH** F0RHAT«4H*RS0 NNR*1 ♦ 

0.0 .2*18 .523* .7854 1.0472 1.309 1.5708 

1.832* 2.0944 2.35*19 2.41799 2.87797 3.141592* 

3.40339 3.4*519 3.92499 4.18879 4.43059 4.71239 

4.97419 5.23599 5.49779 5.75959 4.02139 4.28319 t 

-ADDR NEUH*PSI OLDH** F0RHAT*4H*RS4 NNR*1 * 

0 . » 

END* * 

EXECUTE RBS t 
PARAH IDBANK-0 4 

PARAH HBLADE«3, HZ*. 317, Z*3048.0 0 

EVALUATE RH00«RH0A*5I 5 .240 4 

EVALUATE CO>C0*.3048 S 
EVALUATE VF*VCOH*.3048 * 

EVALUATE OHEGA*RPH*PI/30.0 4 
PARAH IPRINT»4, INFO-1 * 

PARAH BTIP*B,NS*30, IATH«0,NB»NBLADE, RPC-0.0 4 

PARAH ALT*Z CA*CO NHARH-NS RHOA-RHCO 4 
EVALUATE POUREF* RHOO * 1**3 * 0HEGA«*34 
EVALUATE POUER ■ 4. *CP *POUREF /(PI*«3) 0 

EVALUATE PKU*P0UER*0.001/KBLADE » 

EXECUTE PLD 4 

UPDATE NEUU*OBSERV SOURCE** 4 
-ADDR OLDH** NEUH*COORD F0RNAT*4H3RS4 4 
0.0 -2.024 -0.279 9 

0.0 -2.024 -0.40* * 

0.0 -2.024 -0.359 4 

END* 4 

EXECUTE SPN 9 

ENDCS 4 

Figure 3.6-2. Input File for A Single-Pass Mode Operation (Continued) 
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3.7 COMPUTER RESOURCES REQUIREMENTS 

System verifications have focused on the NASA Langley SR-3 propeller 
operating at M» = 0.8 and the Hartzell 101/16 propeller which operates at 
subsonic speeds. Computer resource requirements, namely CPU time and main 
storage, were determined based on these studies. Table 3.7-1 shows the 
system requirements. As noted previously, GAPAS Is developed to operate on 
the CDC computer under the NOS operating system. The total memory 
requirement is 340K octal words which includes the executive system 
routines, functional module, system routines, Intrinsic functions, etc. 
Processing the SR-3 and H101/16 test cases under similar conditions (i.e, 
single pass, 13 spanwise stations and same number of observers for 
acoustics calculations) requires approximately 400 and 800 seconds of 
execution, respectively. The basic difference In CPU time Is due to the 
fact that the airfoil data bank Is used to build the drag polar for the 
SR-3 performance calculations while for the H101/16, TRANSEP is utilized to 
construct the drag polar. It should be pointed out that the estimate for 
SR-3 is based on the assumption that TPN runs without retarded time 
equation problems. 
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Table 3.7-1. GAPAS Limitations and Requirements 


COMPUTER SYSTEM: 

• CDC - NOS OPERATING SYSTEM 

• MEMORY -340,000 OCTAL WORDS 

• CPU TIME ($EC) -400 (SR3, SINGLE PASS) 

13 STATIONS 

-800 (H101/16, SINGLE PASS) 
13 STATIONS 


FUNCTIONAL MODULE 

MODULE 

ATM 

GEOGEN 

JUMPER 

NACA16 

TRANSEP 

PROPCHG 

STRUC (EIGEN) 

PLD 

RBS 

SPN 

TPN 


REQUIREMENT: 

CPU (SEC) 

- 1.0 

113.0 

70.0 

- 2.0 

11.0 

30.0 

43.0 

3.0 

4.0 

40.0 

20 - 120 


MFMORY (OCTAL WORDS) 

- 1,000 

101,000 

50.000 

41.000 

73.000 

36.000 

67.000 (40,000) 

40.000 

40.000 

47.000 

43.000 
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APPENDIX A 

FINITE ELEMENT MATRICES ASSOCIATED WITH THE BEAM 
MODEL DEVELOPMENT 


All of the finite elements that are required for doing a static and/or 
structural dynamic analysis of a rotating blade using a beam model are 
presented. These element matrices were obtained by using a cubic Hermlte 
Interpolation polynomial, foi* the planar deflections (v,w) and a 

quadratic Hermlte polynomial, {$q}, for the axial deflection (u) and the 
torsional rotation (^). Each of the element matrices and arrays can be 
written In the partitioned form as follows: 



-U, 

1 

- + - 

. A 12 . 

1 

- + - 

t A 13 . 

1 

- + - 

> A 14 , 

*21 . 

1 

- + ■ 

. A 22 t 

1 

- + - 

. A 23 . 

1 

■ + - 

L A 24 .. 

A 3 1 , 

1 

■ + - 

. A 32 . 

1 

■ + - 

. A 33 . 

1 

■ + - 

. A 34 . 

r “ “ T 

%l' 

1 I 

. A 42 . 

1 

. A 43 j 

1 

[ A 44j 


(A. 1) 



where the Indices 1, 2, 3, and 4 correspond to the planar deflections, v 
and w, the torsional rotation, and the axial deflection u, respectively. 
Since the finite element matrix and array expressions are complicated, they 
will be expressed in terms of their submatrices and subarrays. 
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A.l. FINITE ELEMENT DEFINITION OF THE STRAIN ENERGY VARIATION 

The finite element matrices and arrays that are associated with the 
strain energy variation are the linear stiffness matrix, the nonlinear 
stiffness matrix, and the nonlinear Jacobian matrix. 

To express the foregoing finite elements In terms of their submatrix 
definition, the following constants are defined: 

EAi7 A = EA»7 a cos /? - EA^ a sin/? 

EA£ a = EA£ a cos /? + EA>7 a sin/? 

EACj = EACj cos/? - EAC2 sin/? 

EAC2 = EACg cos/? + EACj sin/? 

EADj = EADj cos p - EAD2 sin/? 

EAD 2 = EAD 2 cos P + EAD 1 s1n ^ 

EADjj = EADj cos p - EAD£ sin; 

EADg = EAD£ C0S P + EAD i s1n £ 

= {EI w co$2; + EI <r<r s1p2/?) + 2 E1 vs cosp s1n ^ 

= (EI^ cos 2 ; + EI^ sin 2 /?) - 2 El cos/? sin/? 

= ((EI ^ " E V C0SP Sln P + EI i7$‘ (cos ^ ' s1r,2 / ? )) 

The linear stiffness matrix Is defined with the following submatrices 

[ K n ] ■ d * 

[ K 12 ] = { *cH*c> d * 
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EAD 3 




{?»} [{AH?*Hi>H b *} v 5vj - {a}{?« f - 


0 

t — k 

1 


cn 

00 

1 

00 

Ch 




xp {:*}{:*} Vav3 + 
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xp {?*}{«{“«{?*} l gva 



{?*}[ [{A}{i!*H#}{ b «} - {«}{?*}] *SV3 - ]{?♦} * 

{?*}[ [{«}{’*} {«{”♦} + Ca}{?*}] v a« - {#}{?« 0 ava] {?*} + 
£?♦}[{«}{?*}{«}{?♦} ♦ {a} {?♦}»{?«} + {nn! 1 *} z ]{?*} . [ *p, ] 




i 
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r nl i r L i ^ t t t 

l K 41 J ■ J 0 5 “ t^K*p{V}{*i} * EA<r fl {♦•}{* q }W{*y dx 

[ k 42 J ■ J 0 1 EA {♦,){♦;}{«}{♦;} - ea, a dx 

[ K « ] ■ /„ | « c o dx 
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The nonlinear Jacobian matrix Is defined with the following sub- 
matrices: 



VO 

CO 

I 

CO 

vO 


{*”}[ EA?7 a - EA ?a {# q }{#}{*y{W}]{*p 



cos 2 /? {*“}{* jWMp - sin 2 /? {#p{# q }{#){#p ] 


X 

T3 



I 


r-3 

CD 

+ 





Z CM 
O 


—I CM 
Z CM 
r "3 


t*J[ IaJ a [{#-){WJ - {* q }{f»}{*->{V>]]{*^} 
T , T, 


xp {?•}[{*}{?♦}{#}{?♦} °3V3 J + {*}&} ?0V3]{?*} 

[{?*}{*}&}{«*} + ^ S0D w 

1 i i i i 
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Q. 

X 



[ J 33 ] = Iq { V[ {*?M ■ EAD i)^p{W}]{*q} 
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A. 2. FINITE ELEMENT DEFINITION OF THE KINETIC ENERGY VARIATION 

The finite element matrices and arrays that are associated with 
the kinetic energy variation are the mass matrix, the Coriolis damping 
matrix, the centrifugal force matrix, and the centrifugal force array. 

To express the foregoing finite elements In terms of their sub- 
matrix definition, the following constants are defined: 


= "%i cos ^ " m $m s1n ^ 

= m $m cos ^ + m ’m s1n ^ 

% = ( In, „ cos 2 /J + Im^ s1n 2 /J) + 2 Imi/f cos/J sln/J 
15^. = (Im^ cos 2 ^ + Im sln 2 ^) - 2 Im^^- cos p sln/J 

= ((Im^ - Im^) cos/J sin /J + Imi/f (cos 2 /J - sin 2 /J)) 

hQ x ■ (0 y 2 * i! z 2 ) h x - o x fly h y - n x o z h z 
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The linear Coriolis damping matrix is defined with the following sub- 
matrices. All the submatrices are equal to zero except: 


[ M n ] ■ 2 J 0 L ° 2 [<*P«c> - » c H«p] d * 

[ m 12 ] * ' 2 I 0 °x m + °y "%i + "z dx 

["13] " / 0 ' 2 «x W c }{ V + <°y h z * °z h y > %„ WpWq} dx 

[ H lS ] “ 2 J„ B z m d * 

[ *21 ] ■ - [ H 12 ] 

[ M 22 ] ‘ 2 J^y % [ » C H*P - ] <ix 

[ M 23 ] ' \ 0 - 2 °x % C* C W,> * <°z h y - °y h z> % f*JfV dX 
[ M 24 ] = ‘ 2 J 0 °y m ix 

[ **31 ] ■ - [ M 13 ' 
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A. 3. FINITE ELEMENT DEFINITION OF THE EXTERNAL WORK VARIATION 

The finite elements that are associated with the external work 
variation are the externally applied moment stiffening matrix and the 
force array. 

The submatrices associated with the twisting moments going through a 
moderate deflection are defined. All the submatrices are equal to 
zero except: 

[ "ll ] - frx d * 

[ ] * £"x <yty d * 

[ si ] ■ Jj-Oy dx 

[ hi ] - <y <y dx 
[ K « ] ■ tyty dx 

[ K « ] ■ <y <y d * 
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The subarrays associated with the distributed load vector are 


r T A- T T 

{ F J } * i 0 -Py »<:> - <> Z * 

{ F 2 } - J 0 L -»z + (*c> dx 

{ F 3 } ’ l^x ty dx 

{ F I } ■ ty dx 
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